Notion MCP

Live

OAUTH 2.0

PRODUCTIVITY

Productivity

Connect to Notion MCP. Create and update pages, databases, comments, and views from your AI workflows.

  • Acts as the user: Every tool call runs as the authorizing user. Access and audit trail stay intact.
  • Credentials stay vaulted: AES-256 encrypted, resolved at request time, never stored in LLM context.
  • Scoped before every call: Per-user permissions enforced automatically. 90-day audit trail included.
Notion MCP
agent · Acme Q3
Run
Notion-Create-Comment in Notion MCP
S
notionmcp_notion-create-comment
85ms
Notion MCP agent
Add a comment to a notion page or inline discussion thread..
Sources: Notion MCP
notionmcpmcp
1 tool call
18:29
Message Claude...

Notion MCP tools for AI agents

CALL ANY TOOL
12 tools covering notion-create-pages, notion-create-database, notion-create-comment.
notionmcp_notion-fetch
Notion-fetch
Retrieve details about a Notion page, database, or data source by URL or ID.
Parameters
Name
Type
Required
Description
id
string
Required
The ID or URL of the Notion page, database, or data source to fetch. Supports notion.so URLs, Notion Sites URLs (*.notion.site), raw UUIDs, and data source URLs (collection://...).
include_discussions
boolean
Optional
Set to true to include discussion threads in the response.
include_transcript
boolean
Optional
Set to true to include a meeting transcript in the response.
notionmcp_notion-search
Notion-search
notionmcp_notion-get-teams
Notion-get-teams
notionmcp_notion-get-users
Notion-get-users
notionmcp_notion-move-pages
Notion-move-pages
notionmcp_notion-create-view
Notion-create-view
notionmcp_notion-update-page
Notion-update-page
notionmcp_notion-update-view
Notion-update-view
notionmcp_notion-create-pages
Notion-create-pages
notionmcp_notion-get-comments
Notion-get-comments
notionmcp_notion-create-folder
Notion-create-folder
notionmcp_notion-search-agents
Notion-search-agents
notionmcp_notion-update-folder
Notion-update-folder
notionmcp_notion-create-comment
Notion-create-comment
notionmcp_notion-duplicate-page
Notion-duplicate-page
notionmcp_notion-get-async-task
Notion-get-async-task
notionmcp_notion-create-database
Notion-create-database
notionmcp_notion-create-attachment
Notion-create-attachment
notionmcp_notion-list-recent-pages
Notion-list-recent-pages
notionmcp_notion-list-shared-pages
Notion-list-shared-pages
notionmcp_notion-create-file-upload
Notion-create-file-upload
notionmcp_notion-list-private-pages
Notion-list-private-pages
notionmcp_notion-query-data-sources
Notion-query-data-sources
notionmcp_notion-update-data-source
Notion-update-data-source
notionmcp_notion-download-attachment
Notion-download-attachment
notionmcp_notion-list-favorite-pages
Notion-list-favorite-pages
notionmcp_notion-query-meeting-notes
Notion-query-meeting-notes
notionmcp_notion-convert-page-to-skill
Notion-convert-page-to-skill
Build your Agent
Same auth pattern across every framework.
Python · LlamaIndex
from langchain_mcp_adapters.client import MultiServerMCPClient
from scalekit import ScalekitClient

client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="notionmcp")

mcp = MultiServerMCPClient({
"notionmcp": {
"url": "https://mcp.scalekit.com/notionmcp",
"headers": {"Authorization": "Bearer " + token}
}
})
tools = await mcp.get_tools()
import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "notionmcp" });

const openai = new OpenAI();
// Connect to MCP at https://mcp.scalekit.com/notionmcp
// Pass: Authorization: Bearer + token
import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const client = new ScalekitClient({ envUrl, clientId, clientSecret });
const token = await client.agent.getToken({ userId: "user_id", connector: "notionmcp" });

const anthropic = new Anthropic();
// Connect to MCP at https://mcp.scalekit.com/notionmcp
// Pass: Authorization: Bearer + token
from google.adk.agents import LlmAgent
from scalekit import ScalekitClient

client = ScalekitClient(env_url=ENV_URL, client_id=CLIENT_ID, client_secret=SECRET)
token = client.agent.get_token(user_id="user_id", connector="notionmcp")
# Connect to MCP at https://mcp.scalekit.com/notionmcp
# Pass: Authorization: Bearer + token
Try these prompts
Paste any prompt into your agent to get started.
Get started
Copy the prompt
Copied
Update a Notion database view’s name, filters, sorts, or display configuration?
Copy the prompt
Copied
Update a Notion page’s properties, content, icon, cover, or verification status?
Advanced
Copy the prompt
Copied
Update a Notion data source’s schema, title, or attributes using SQL DDL statements?
Copy the prompt
Copied
Search pages, databases, and connected sources in the Notion workspace?
SEE HOW AUTH WORKS
User authorises once. Every agent call after uses their token with scope enforcement.
1
Authorize
Your user connects
Notion MCP
once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access
Who:
user ‘A’
when:
Once per user
access:
Limited to user
2
Store
Their
Notion MCP
token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection
vault:
encrypted
scope:
per-user
tokens:
auto-refreshed
3
Resolve
When your agent calls a
Notion MCP
tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs
speed:
~40ms
check:
before every call
seen by:
nobody
4
Audit
Every
Notion MCP
tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it
history:
90 days
export:
SIEM-ready
logged:
every call
Test other agents
See the same per-user auth pattern across other connectors.
GTM and RevOps Teams
Competitive intelligence briefing agent
Scans Gong calls for competitor mentions, matches each one to its Notion battlecard, and DMs every affected rep a single Slack digest per cycle. Every call runs as the PMM who owns the briefing, never a shared bot.
People Ops and HR teams
Performance review collector
Collects review feedback from Airtable and Google Forms scoped to each manager's direct reports, writes per-employee summaries to Notion, and DMs the manager a Slack digest.
GTM and RevOps Teams
Deal room sync
Pulls opportunity context from Salesforce, captures key decisions from Slack, and syncs a running summary to the deal room doc in Google Drive, but only when the deal actually changed.
People Ops and HR teams
Offer letter routing agent
Drafts the offer in PandaDoc, blocks on the hiring manager's approval in Slack, then emails the candidate their e-signature link. Every call runs as the recruiter who triggered it, never a shared HR bot.
Test other agents
See the same per-user auth pattern across other connectors.
PEOPLE OPS
Performance review collector agent
Collect review feedback from Airtable and Google Forms per manager, summarise each report in Notion, and DM the digest in Slack.
GTM
Competitive intelligence briefing agent
Scan Gong calls for competitor mentions, match each one to its Notion battlecard, and DM every affected rep a single Slack digest.
GTM
Deal room sync agent
Pull opportunity context from Salesforce, capture decisions from Slack, and keep the Google Drive deal room doc current.
PEOPLE OPS
Offer letter routing agent
Draft the offer in PandaDoc, gate it on hiring manager approval in Slack, then email the candidate their signature link.
Why Scalekit
Secure your agent's access. Connectors ship in minutes
01.
Shared tokens break per-user analytics
A shared token looks fine in a demo. In production every call looks like a service account. Scalekit resolves the real user credential.
// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓
02.
Authentication is not authorization
03.
Multi-tenancy is architectural
04.
One connector today. Ten tomorrow.
“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”
Venu Madhav Kattagoni
Head of Engineering / Von
FAQs
Frequently Asked Questions

Does the agent access Notion as the user or as a shared key?
As the user. Each workspace member authorizes once and Scalekit resolves their credential at request time. Audit logs attribute every action to that user, not a shared service account.

Where is the Notion OAuth token stored?
In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Tokens never appear in prompts, logs, or LLM context.

Can I limit what the agent is allowed to do in Notion?
Yes. Pass a tool name filter to listScopedTools so the productivity agent only sees the subset you authorize. Pre-API-call scope checks block out-of-policy actions before the request reaches Notion.

What happens when a user revokes Notion access?
The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Can the agent access private pages and databases?
Only pages and databases shared with the authorizing user. Cross-user access stays denied. The agent inherits the user's Notion read and write scope at request time.

Start in your coding agent
Up and running in one command
Install the Scalekit skill in your editor of choice. Connector, auth, tools, prompt, all wired up
Claude Code REPL
/plugin marketplace add scalekit-inc/claude-code-authstack
/plugin install agentkit@scalekit-auth-stack
Cursor Code REPL
# ~/.cursor/mcp.json
{
""mcpServers"": {
""notionmcp"": {
""url"": ""https://mcp.scalekit.com/notionmcp"",
""headers"": { ""Authorization"": ""Bearer $SCALEKIT_TOKEN"" }
}
}
}
Codex Code REPL
# ~/.codex/config.toml
[mcp_servers.notionmcp]
url = ""https://mcp.scalekit.com/notionmcp""
auth_env = ""SCALEKIT_TOKEN""
Copilot Code REPL
# .vscode/mcp.json
{
""servers"": {
""notionmcp"": {
""url"": ""https://mcp.scalekit.com/notionmcp"",
""type"": ""http""
}
}
}