MCP server · Projects and team work
Notion MCP server
Lets an assistant search, read, create and update pages and databases in your Notion workspace through Notion’s hosted server.
- Maintainer
- Notion (official)
- Licence
- Not published (hosted service)
- Runs
- Remote (URL)
- Sign-in
- OAuth sign-in in the app
- Registry version
- 1.0.1 (updated 2025-09-11)
- Last activity
- 2026-10-13
- Source
- Official docs
Overview
What it does
Notion MCP is a remote server hosted by Notion at mcp.notion.com. You connect with OAuth, and the client can then use Notion’s tools on any content your account can reach. Pages are read and edited as Markdown, which keeps responses compact. Notion also publishes an open-source local server (makenotion/notion-mcp-server, run with npx @notionhq/notion-mcp-server and a NOTION_TOKEN), but its README says it is no longer actively maintained and points users to the hosted server.
It suits teams that keep specs, meeting notes and project databases in Notion and want an assistant to find decisions, draft pages or update database entries. On Business and Enterprise plans with Notion AI, notion-search also runs AI search across connected sources such as Slack, Google Drive and Jira; other plans get keyword search. A notion-get-tool-access tool reports which tools and filters the workspace plan allows. Workspace owners can review and revoke connections under Settings, Connections.
Tools
What the assistant can do
- Search Notion and connected sources, or look up users
- Fetch pages, databases and data sources
- Create, update, move and duplicate pages
- Create databases, folders and views, and query across data sources
- Add and read comments
- Query meeting notes
- Move pages and databases to Trash after confirmation, and restore them
Install
Install Notion MCP server in your app
You need:
- A Notion account
- An MCP client with remote server and OAuth support
- A Business or Enterprise plan with Notion AI for AI search and some filters
Run in your project. --scope local keeps the servers private to you in this project; use user for every project.
claude mcp add --scope local --transport http notion https://mcp.notion.com/mcp
- notion: sign in when the app asks (run /mcp in Claude Code).
Project root. Commit it to share the servers with your team; each person sets the variables in their own shell.
{
"mcpServers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
}
}
}
- notion: sign in when the app asks (run /mcp in Claude Code).
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json (Settings → Developer → Edit Config). Restart Claude after saving.
{
"mcpServers": {}
}
- notion is a remote server: add it as a custom connector (Customize → Connectors → + Add → Add custom connector; on Team and Enterprise plans an owner adds it under Organization settings → Connectors), with the URL https://mcp.notion.com/mcp.
In your project, or ~/.cursor/mcp.json for every project.
{
"mcpServers": {
"notion": {
"url": "https://mcp.notion.com/mcp"
}
}
}
- notion: sign in when the app asks.
In your workspace. VS Code asks for each secret the first time a server starts and stores it securely.
{
"servers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
}
}
}
- notion: sign in when the app asks.
macOS/Linux: ~/.config/devin/mcp_config.json · Windows: %APPDATA%\devin\mcp_config.json. Read by the default Devin Local agent and by the legacy Cascade agent.
{
"mcpServers": {
"notion": {
"url": "https://mcp.notion.com/mcp"
}
}
}
- notion: sign in when the app asks.
Want it alongside other servers? Open Notion MCP in the MCP config generator and add the rest; it writes one file per app. The snippets follow the setup in the server’s README, checked on 2026-10-14.
Before you install
- A connected client can read and change anything you can access in the workspace, including moving pages and databases to Trash.
- Notion warns that page content can carry prompt injection. Treat tool output as untrusted and turn on confirmation before actions that change content.
- A remote server sees whatever the assistant sends it. Sign in with the narrowest access the service offers. See how to choose a safe server.
Why it’s listed
Why we list it
The vendor-hosted server for a widely used docs and wiki tool, with Markdown-based editing and admin controls over connections.
Related
More MCP servers
- Linear MCP serverLets an assistant find, create and update Linear issues, projects and comments through Linear’s hosted server.
- Atlassian Rovo MCP ServerConnects an assistant to Jira, Confluence, Bitbucket Cloud, Compass and Loom on your Atlassian Cloud site via Atlassian’s hosted server.
- Slack MCP serverLets an assistant search Slack, read channels and threads, send messages and work with canvases, files and lists.
- Asana MCP serverLets an assistant search, read, create and update Asana tasks, projects and portfolios through Asana’s hosted V2 server.
- Zapier MCPLets an assistant act in thousands of apps through your Zapier account, such as sending email, posting to Slack or updating a CRM.
All MCP serversMCP config generatorGuide: MCP servers in Claude CodeGuide: what is MCP?