Connect the Notion API

• ✓ Pages & blocks
• ✓ Databases
• ✓ Comments
• ✓ Token expiry
• — Webhooks (Poll via search/database queries)

search_

pages · databases by title

pages_

get · create · update · append blocks

databases_

schema · query with filters

users_

list

comments_

list · add

OAuth scopes requested

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

# Add Modiva's MCP server to your agent
{
  "mcpServers": {
    "modiva": {
      "url": "https://mcp.modiva.ai",
      "headers": { "Authorization": "Bearer $MODIVA_MCP_KEY" }
    }
  }
}

# Then connect Notion and call its tools, e.g.
accounts_list(provider="notion")

How do I connect the Notion API with Modiva?

Create a Modiva account, generate an MCP key, and connect Notion from your dashboard. Modiva runs the full OAuth flow and stores the encrypted token for you — no client secrets in your code.

What can I do with the Notion API through Modiva?

Search, read and write Notion pages and databases, query content calendars, and manage comments across the pages you share. You get 11 typed tools grouped by resource (search_, pages_, databases_, users_, comments_), callable over REST or the MCP server.

Do I need to handle OAuth or token refresh myself?

No. Modiva handles the Notion OAuth handshake, token storage (envelope-encrypted) and automatic refresh. You call a single unified endpoint.

Can an AI agent use the Notion API?

Yes — that is the point. Modiva exposes Notion as Model Context Protocol (MCP) tools, so agents like Claude, Cursor or your own app can read and act on Notion through one endpoint.