How to connect Notion to Riflet

What you need before you start

A Notion account, and the right to create a connection in the workspace you want to read. On a personal workspace you have it. On a company workspace an admin may have restricted connections, in which case you either ask them to create one or take the Markdown export route instead, which needs no permissions at all.

Notion moved connection management into a Developer section in August 2026. Guides that send you to a My Integrations page were written before that and their screens will not match yours.

Create your Notion connection

A connection is Notion's own term for what used to be called an internal integration. It is yours, it lives in your Notion account, and you can delete it at any moment.

Give the connection access to your pages

This is the step that catches nearly everyone. Creating a connection grants it nothing. At this point it can see no pages, no databases, and nothing at all in your workspace, which is why Riflet shows an empty tree if you skip ahead.

From the connection. Open your connection in Notion and go to its Content Access tab. Add the pages and databases you want Riflet to read. Granting a parent page brings its sub-pages with it, so a single top-level project page is usually enough.

From a page. Anyone who can edit a page can also share it with a connection from that page's own menu. This is the route to use when a colleague owns the page you need.

Connect the workspace in Riflet

You can repeat this with a second workspace using Connect another workspace, since a connection only ever covers one workspace. Switch between them from the workspace picker, and use Refresh workspace whenever you grant new pages in Notion.

What Riflet can and cannot see

Riflet talks to Notion's REST API and only ever reads. It lists the pages and databases your connection has been granted, rebuilds their hierarchy, and fetches the content of the ones you select. That is the whole surface.

• It never writes: no new pages, no edits, no comments, no deletions.
• It never sees pages you have not granted in Content Access, including anything private to a teammate.
• Page content goes straight from Notion's API to your computer. Riflet runs no server that sees your pages.
• Your secret stays on your machine, encrypted with a key kept in your operating system's credential store: the macOS Keychain, Windows Credential Manager, or your desktop password store on Linux.

When you are done, delete the connection in Notion to invalidate the secret everywhere at once. Removing the workspace inside Riflet only deletes the copy stored on your machine.

Notion setup troubleshooting

Riflet connected but my workspace is empty.

This is the Content Access step, and it catches nearly everyone. A Notion connection starts with access to nothing, so a valid token with no granted pages produces exactly this: a successful connection and an empty tree. Open your connection in Notion, go to the Content Access tab, add the pages and databases you want, then click Refresh workspace in Riflet.

Riflet says my Notion token is invalid.

Two common causes. You copied something other than the Internal Integration Secret, such as the connection's ID or a public integration's client secret. Or the secret was regenerated in Notion after you pasted it, which invalidates the old one immediately. Go back to Settings, Developer tools, Connections, open your connection, copy the whole secret, and paste it again. It always starts with ntn_.

I cannot find Developer tools in my Notion settings.

Notion moved connection management into a Developer section in August 2026, and on some accounts it stays hidden until developer features are switched on in Settings. If you followed an older guide to a My Integrations page, that route is out of date. If the section is missing entirely, your workspace admin has probably restricted who can create connections, and you will need them to create one or use the Markdown export route instead.

A page I granted still does not appear in Riflet.

Riflet caches the workspace tree, so a page added in Notion after you connected will not appear on its own. Click Refresh workspace in Riflet. If it is still missing, check that you granted the page itself rather than a page that merely links to it, and remember that granting a parent page brings its sub-pages along while a linked database view does not bring its source database.

Can I connect more than one Notion workspace?

Yes. Each workspace needs its own connection and its own secret, since a connection is scoped to a single workspace. In Riflet, use Connect another workspace, then switch between them from the workspace picker. You can remove any one of them without touching the others.

How do I revoke Riflet's access to my Notion?

Delete the connection in Notion, under Settings, Developer tools, Connections. That invalidates the secret everywhere at once, so nothing holding a copy of it can read your pages afterwards. Removing the workspace inside Riflet deletes the stored token from your machine, but it does not revoke the connection at Notion's end, so do both if the token may have been exposed.

Will my teammates see the connection?

Anyone who can open your connection's settings can see that it exists, what it is called, and which pages it has been granted. Notion also shows a connection on the pages it can read. It never posts or edits anything, because Riflet requests read access only.