Skip to content
API Reference
Notion logo

Notion

Productivity

All-in-one workspace for notes, docs, and project management

Connect your AI assistant to Notion to search, read, and manage pages, databases, and content across your workspace. Enables agents to create pages, update properties, query databases, and organize knowledge on your behalf.

Adding Notion provisions three things in your zone: an upstream resource pointing at https://mcp.notion.com/mcp (kept inside Keycard), a Keycard MCP Gateway URL - the downstream resource - that you install in Cursor, Claude Code, or any MCP client, and a provider for token exchange with Notion’s OAuth issuer.

When your AI client makes a tool call, it sends a Keycard-issued access token to the gateway URL. Keycard’s STS exchanges that token for an upstream Notion token, the gateway calls the upstream MCP, and the response is proxied back. Your zone’s identity provider, access policies, and audit log apply to every call - the upstream credential never leaves Keycard. Each call is recorded in the audit log with the user identity, the resource accessed, and the policy decision.

Tools the upstream server exposes through the Keycard MCP Gateway.

Notion exposes 14 tools through the gateway:

notion-search
Search Notion workspace and connected tools
notion-fetch
Get a Notion page, database, or data source by ID
notion-create-pages
Create Notion pages with properties and content
notion-update-page
Update a Notion page's properties or content
notion-move-pages
Move Notion pages or databases to a new parent
notion-duplicate-page
Duplicate a Notion page
notion-create-database
Create a Notion database using SQL DDL syntax
notion-update-data-source
Update Notion data source schema via SQL DDL
notion-create-comment
Add a comment to a Notion page or block
notion-get-comments
Get comments and discussions from a Notion page
notion-get-teams
List teamspaces in the Notion workspace
notion-get-users
List users in the Notion workspace
notion-create-view
Create a new view on a Notion database
notion-update-view
Update a Notion view's filters, sorts, or layout

Add Notion to your zone and install the gateway URL into Cursor, Claude Code, or any MCP client.

  1. Open the catalog

    In your zone’s Keycard Console, go to ApplicationsAdd ApplicationExplore MCP Servers.

  2. Find and install Notion

    Search for Notion in the catalog and click Install.

  3. Connect your development tool

    Once installed, Notion appears on the Applications page with a Keycard MCP Gateway URL. Use the Install dropdown to add it to Cursor, Claude Code, or any MCP-compatible client.