Notion MCP Server

Pricing

Rating

Developer

Actor stats

Categories

Share

Cloud MCP Server for Notion. Connect AI agents (Claude, GPT, Cursor) to your Notion workspace with 20 API operations for pages, databases, blocks, and comments.

Features

• 20 Operations - Full Notion API coverage
• Demo Mode - Test without authentication
• URL Support - Accept Notion URLs or IDs
• Pagination - Handle large datasets with cursors
• Error Handling - Clear messages with API codes

Quick Start

Demo Mode (No Setup)

{
"operation":"demo"
}

Search Your Workspace

{
"notionToken":"ntn_your_token_here",
"operation":"search",
"query":"Meeting Notes"
}

Setup

1. Create a Notion Integration

1. Go to notion.so/profile/integrations
2. Click New integration
3. Name it (e.g., "Apify MCP")
4. Copy the token (starts with ntn_)

2. Share Pages with Integration

For each page/database you want to access:

1. Open the page in Notion
2. Click ... menu → Connections
3. Select your integration

Input Parameters

Operations

Search & Discovery

Pages

Databases

Blocks

Comments & Users

Examples

Search Pages

{
"notionToken":"ntn_xxx",
"operation":"search",
"query":"Project Plan"
}

Get Page by URL

{
"notionToken":"ntn_xxx",
"operation":"get_page",
"pageId":"https://notion.so/My-Page-abc123def456"
}

Query Database with Filter

{
"notionToken":"ntn_xxx",
"operation":"query_database",
"databaseId":"abc123",
"filter":"{\"property\":\"Status\",\"select\":{\"equals\":\"Done\"}}"
}

Create Page with Content

{
"notionToken":"ntn_xxx",
"operation":"create_page",
"parentPageId":"parent-id",
"title":"New Page",
"children":"[{\"object\":\"block\",\"type\":\"paragraph\",\"paragraph\":{\"rich_text\":[{\"type\":\"text\",\"text\":{\"content\":\"Hello world!\"}}]}}]"
}

Output Schema

Success Response

{
"operation":"search",
"success":true,
"objectType":"search_results",
"content":[...],
"resultCount":10,
"hasMore":false
}

Error Response

{
"operation":"get_page",
"success":false,
"error":"[object_not_found] Could not find page",
"errorCode":"object_not_found"
}

MCP Integration

Claude Desktop

{
"mcpServers":{
"notion":{
"command":"npx",
"args":["-y","@anthropic/apify-mcp-client","constant_quadruped/notion-mcp-server"]
}
}
}

Apify Client (JavaScript)

import{ ApifyClient }from'apify-client';
const client =newApifyClient({token:'YOUR_APIFY_TOKEN'});
const run =await client.actor('constant_quadruped/notion-mcp-server').call({
notionToken:'ntn_xxx',
operation:'search',
query:'Meeting Notes'
});
const{ items }=await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Apify Client (Python)

from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("constant_quadruped/notion-mcp-server").call(run_input={
"notionToken":"ntn_xxx",
"operation":"search",
"query":"Meeting Notes"
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items)

Troubleshooting

Resources

• Notion API Docs
• Create Integration
• Block Types
• Model Context Protocol

License

MIT