MCP ServerHTTP

Notion MCP Server

Notion ships an official MCP server at mcp.notion.com/mcp that lets any AI model read and write pages, databases and comments in your workspace. Authenticate with a Notion integration token, paste the URL into any MCP client, and your knowledge base becomes a live agent surface.

Hosted URL

https://mcp.notion.com/mcp

Suggested model

Claude Sonnet 4.5

MCP Playground runs 30+ models on the same workflow: switch anytime, or use Compare mode to run several in parallel and balance quality vs. cost.

Auth

Notion integration token. Create one at notion.so/profile/integrations, then share the pages or databases you want the agent to access.

What the Notion MCP server does

How models use it and what it is built for.

The Notion MCP server exposes the Notion API as MCP tools — searching across pages by query, reading page content as structured blocks, querying databases with filters, creating or updating pages, and managing comments. Models can answer "find the latest engineering RFC about X", summarise a project doc, draft a new page from a template, or roll up a database into a status report. Because Notion runs the server, there is no infrastructure to manage — only an integration token to provision.

Tools the Notion MCP server exposes

Typical tools an AI model can call. Exact names vary by version.

  • search — full-text search across pages and databases
  • get_page — read page content as structured blocks
  • query_database — filter, sort and paginate database rows
  • create_page — create a new page or database row
  • update_page — patch page properties or append blocks
  • list_comments / create_comment — read or post comments

Example prompts to try

Copy any of these into MCP Agent Studio after connecting.

  • Search my workspace for the latest doc about Q2 planning and summarise it.

  • Find every page tagged "RFC" updated in the last 14 days and list the authors.

  • Create a new page in the Engineering wiki titled "Onboarding 2026" with these sections.

  • Summarise the comments on this page and tell me what is unresolved.

Models on MCP Playground

This is not a single-model product: you get the same MCP connection with 30+ models (Claude, GPT, Gemini, DeepSeek, open-weight, and more), you can switch mid-conversation, and you can open Compare mode to run the same prompt against multiple models at once. The card above is a suggested starting point for this server — not the only choice.

Default pick for Notion

Claude Sonnet 4.5

Claude Sonnet 4.5 handles long doc summarisation and multi-step Notion search well. Use Haiku for cheap quick searches; GPT-5.2 for creative writing into pages.

Try the Notion MCP server in your browser

Open MCP Agent Studio with the connection pre-filled. Add your token, pick any of 30+ models, and start chatting — no install required.

Try Notion in Agent Studio

Notion MCP server — FAQ

Common questions about connecting, scoping and using it safely.

What is the Notion MCP server?

It is an official MCP server hosted by Notion at mcp.notion.com/mcp. It exposes the Notion API as tools an AI model can call — searching, reading, creating and editing pages and databases in your workspace.

How do I get a Notion integration token?

Go to notion.so/profile/integrations, create a new internal integration, and copy the secret. Then open the pages or databases you want the agent to see, click Share → Add connections, and select your integration.

Can the Notion MCP server write to my workspace?

Yes — it can create pages, update properties and post comments, but only on pages your integration has been explicitly shared with. Notion enforces this at the API level, so you can scope an agent to a single database if you want.

Is the Notion MCP server free?

Yes, the MCP server is free to use with any Notion plan that supports integrations. AI model costs are billed separately by your model provider, or covered by your MCP Agent Studio credits if you run it in-browser.

Which model is best for Notion knowledge work?

For long-doc summarisation and multi-step research, Claude Sonnet 4.5 is the most reliable. For quick lookups and high-volume search, Claude Haiku 4.5 or GPT-5.2 mini are cheaper. Compare them on your own pages in Agent Studio.

Other MCP servers

More on MCP Playground