Skip to main content
modiva.ai
Sign In
← All docs

Setup guide

Connect Notion

ProductivityOAuthNotion developer docs ↗

Notion connects through OAuth 2.0 as a public integration. You authorize Modiva from Notion's own consent screen — and, crucially, you pick exactly which pages and databases to share. Modiva only ever sees the content you select; everything else in your workspace stays invisible. Once connected, Modiva can search your shared content, read pages and blocks, create and update pages, query databases and add comments — perfect for running a content calendar in Notion, scheduling those posts across your social platforms, and writing analytics back into the same database. Notion access tokens never expire, so the connection stays healthy without any refresh or reconnect.

Before you start

  • A Notion account with access to the workspace you want to connect.
  • Permission to authorize a third-party integration and share pages or databases with it.

Step-by-step setup

  1. 1

    Sign in to Modiva

    Log in at modiva.ai and open the Dashboard. You need a Modiva account before you can connect any platform — creating one takes a minute and no credit card is required for the free tier.

  2. 2

    Open Connections → New connection

    In the left sidebar choose Connections, then click New connection. You'll see the full catalogue of platforms grouped by category (Social, Ads, CRM, E-commerce, Marketing, Creative, Productivity, Payments, Dev & Infra and Analytics).

  3. 3

    Select Notion and authorize

    Click the Notion card. Modiva redirects you to Notion's official consent screen — sign in, choose the workspace, then select the specific pages and databases you want Modiva to access. Only what you pick is shared; the rest of your workspace stays private. Your password is entered on Notion, never on Modiva.

  4. 4

    You're connected

    Notion sends you back to Modiva and the connection appears with a green Connected status. From here it's available to every MCP key and API call in your workspace. Notion tokens never expire, so there's nothing to refresh — the connection stays live until you revoke it.

What Modiva can access

Notion shows the requested access on its consent screen before you approve — and the capabilities only apply to the pages and databases you explicitly share. Modiva can read and update shared content, query shared databases, append blocks and manage comments; anything you don't share stays completely invisible. You can revoke access any time from Notion or by disconnecting in Modiva.

  • Read content on shared pages
  • Insert and update content on shared pages
  • Read workspace users (without emails)
  • Read and add comments

Troubleshooting & FAQ

Does Notion connect with OAuth or an API key?

With OAuth 2.0 as a Notion public integration. You authorize Modiva on Notion's own consent screen; Modiva only receives a scoped token, which is encrypted at rest with AES-256-GCM. Your password is never entered on Modiva.

Which pages and databases can Modiva see?

Only the ones you select on Notion's consent screen. Notion doesn't use per-request scopes — instead, you choose exactly which pages and databases to share when you authorize, and Modiva is blind to everything else in your workspace. Shared pages include their sub-pages.

Why can't Modiva see my page?

The page wasn't shared with the connection. Either open the page in Notion, click Share (the ••• menu → Connections) and add the Modiva connection, or re-run the connect flow in Modiva and select the page on the consent screen. Sub-pages of an already-shared page are included automatically.

Can Modiva write to my Notion workspace?

Yes, on shared content: it can create and update pages, append blocks, update database entries and add comments. It cannot touch pages you haven't shared, and it can't read workspace members' email addresses. A common pattern is a content calendar database — Modiva reads scheduled rows, publishes the posts, then writes status and analytics back.

Do I ever need to reconnect Notion?

No. Notion access tokens never expire (like Slack), so there's no refresh cycle and no periodic re-authorization. The connection only stops working if you disconnect it in Modiva or revoke the integration from Notion's settings.

How do I disconnect?

Open Connections, click the Notion row and choose Disconnect — Modiva deletes the stored token immediately. You can also revoke the integration from Notion under Settings & Members → My connections.

Need help with Notion?

Reach the team any time from our support page, or ask Fin, our AI support agent.