Notion MCP server
Notion's official hosted server for searching, reading and editing pages, databases and comments in your workspace as Markdown. Authorize through OAuth with your existing Notion permissions.
Remote (HTTP)OAuth
Set up Notion
Configuration examples, not tested connections. Replace placeholders and review the upstream documentation before use.
Claude Code
Run in your terminal.
claude mcp add --transport http notion https://mcp.notion.com/mcp
Cursor
Merge into ~/.cursor/mcp.json
{
"mcpServers": {
"notion": {
"url": "https://mcp.notion.com/mcp"
}
}
}
Codex
Run in your terminal.
codex mcp add notion --url https://mcp.notion.com/mcp
codex mcp login notion
Gemini CLI
Merge into ~/.gemini/settings.json
{
"mcpServers": {
"notion": {
"httpUrl": "https://mcp.notion.com/mcp"
}
}
}
OpenCode
Merge into ~/.config/opencode/opencode.jsonc
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"notion": {
"type": "remote",
"url": "https://mcp.notion.com/mcp",
"enabled": true
}
}
}
VS Code
Merge into .vscode/mcp.json
{
"servers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
}
}
}
Using more than one server?Add to a config with other servers
Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, add the URL as a custom connector. This is a remote server with OAuth sign-in; see remote vs local servers and authentication and security basics.
Overview
Notion MCP is Notion's hosted server at https://mcp.notion.com/mcp, documented on developers.notion.com. Notion now focuses its support on this remote server. Its open-source local server, makenotion/notion-mcp-server, is no longer actively supported and may be retired, so new setups should use the hosted one.
The tools work with Notion's own content model and return Markdown. notion-search searches your workspace, including connected apps where your plan allows, and notion-fetch reads a page or database. notion-create-pages and notion-update-page write content, notion-create-comment adds comments, and notion-query-data-sources queries databases. Further tools manage views, files, users and teams. Notion's documentation also covers using Notion pages as reusable agent skills.
Authorization uses OAuth, and the connection respects the permissions you already have in Notion. You don't need to create an integration or share pages manually. In Claude Code, add the URL and authenticate with /mcp; in Codex, run codex mcp login notion. Workspace admins can list and revoke members' MCP connections and can enforce enterprise-managed authorization. Because the agent can edit anything you can edit, review its changes when you use write tools on shared pages.
Example tools
notion-searchnotion-fetchnotion-create-pagesnotion-update-pagenotion-create-commentnotion-query-data-sources
Tool names are upstream examples. The server's live tool list can differ.
Related Productivity servers
Sources
This page was written from the upstream documentation below and last reviewed on 11 October 2026. Listing is not a security or compatibility endorsement. Report a correction through the contact page.