Notion MCP Server

Official

Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.

Local + remotestdiostreamable-httpTypeScriptMIT 3.3k

What is the Notion MCP server?

Notion is where teams keep everything and find nothing. The official Notion MCP server addresses the second half: your assistant can search across the workspace, read pages and databases, create and update content, and work with comments — with the results of that famously fuzzy Notion search actually read and synthesized for you.

Notion built this properly. The hosted server at mcp.notion.com uses OAuth (you sign in, you choose what it can access) and speaks a Markdown-flavoured representation of Notion content that's dramatically more token-efficient than the raw API's JSON — an important detail when a big page might otherwise eat your context window. Setup is a URL, not an integration token ritual, though token-based setup remains available for automation.

The workflows write themselves. "What's our parental-leave policy?" pulls the answer from whatever wiki page holds it. Meeting notes become structured action items in the tasks database. A messy braindump page becomes an organised doc. Databases get queried conversationally — "which projects in the roadmap are marked at-risk?" — without ever building a filtered view.

Where it changes daily work most is capture: things you'd never file because opening Notion and finding the right database is friction, now get filed because saying "add this to the reading list" is not. Access follows your OAuth grant, so scope it deliberately — a workspace admin connecting everything is handing the assistant broad reach. Start with the spaces you actually want it working in; you can widen later.

Scoping the connection sensibly

  • Grant one well-chosen parent page at the OAuth screen — everything nested under it comes along, which beats ticking a whole teamspace.
  • In token mode the same control lives on the page itself: Connections → Add connections, so access stays auditable from where the content is.
  • Ask for a database's schema before bulk writes; Notion resolves people, dates and selects by ID, and unmatched values get dropped rather than flagged.
  • Revoke from Notion's Settings → Connections, not your MCP client — deleting the local entry leaves the grant live.

What you can do with it

Wiki answers

Company-knowledge questions answered from the pages that hold the answers.

Meeting notes → tasks

Action items extracted and filed into the right database with owners and dates.

Frictionless capture

Ideas, links and notes filed correctly by saying so, not by navigating to the spot.

Available tools

ToolWhat it does
searchSearch pages and databases across the connected workspace
fetchRead a page or database's full content
create-pagesCreate new pages with content, in a parent page or database
update-pageEdit page properties and content
move-pagesReorganise pages across the hierarchy
create-database / update-databaseCreate and modify database schemas
create-comment / get-commentsWork with page comments

How to install the Notion MCP server

claude mcp add --transport http notion https://mcp.notion.com/mcp

Browser opens to authorise; you pick which pages/spaces the connection can access.

Configuration

A Notion account. Remote mode: OAuth in the browser. Local mode: an internal integration token plus page sharing.

VariableDescriptionRequired
NOTION_TOKENInternal integration token (local mode only; remote uses OAuth)e.g. ntn_...Optional

Example prompts to try

  • Search our workspace for the onboarding checklist and summarise the engineering steps.
  • From these meeting notes, create tasks in the Projects database with owners and due dates.
  • Which roadmap items are marked at-risk, and what do their status notes say?

Frequently asked questions

Remote (mcp.notion.com) for people: OAuth sign-in, per-space access choices, no token handling. The npm/token route suits automation and self-hosted contexts where a browser flow doesn't fit.