Skip to content

MCP server

Notion MCP server

Notion's official hosted MCP server lets AI search and read pages, create and update pages and databases, query data and add comments.

At a glance

Maintained by
Notion
Tools exposed
10 listed below
Reviewed
September 24, 2026

Why it matters

What it does and why it matters

Notion is where many teams keep documentation, meeting notes, wikis and project databases. Notion's official hosted MCP server lets an assistant search the workspace, read pages, create and update pages, move them, create databases, query data sources and read or add comments.

That makes it one of the most useful servers for everyday knowledge work: turning meeting notes into tasks, finding the latest policy or drafting a project page from a brief.

The self-hosted Notion MCP repository is no longer maintained, and Notion recommends its hosted server, which signs in through your Notion account and follows your page permissions. We connect with an account that sees only the needed teamspaces, and we label pages created by the assistant.

Use cases

Best business use cases

Meeting notes to tasks

Turn notes into tasks in a database. See meeting notes and follow-ups.

Find knowledge

Answer questions from your wiki. See knowledge base search.

Draft pages

Draft project briefs and plans from a few lines.

Database queries

Ask questions of Notion databases.

Comments

Add review comments to pages.

Tools

Available tools

Tool names as published by the maintainer at review time. Versions change, so check the repository for the current list.

Read and write: Read and write for pages, databases, views and comments.

  • notion-search

    Searches the workspace.

  • notion-fetch

    Reads a page, database or data source by URL or ID.

  • notion-create-pages

    Creates pages with properties and content.

  • notion-update-page

    Changes page properties or content.

  • notion-move-pages

    Moves pages or databases to a new parent.

  • notion-create-database

    Creates a database.

  • notion-query-data-sources

    Queries data sources or runs saved views.

  • notion-create-comment

    Adds a comment to a page or block.

  • notion-get-comments

    Lists comments on a page.

  • notion-get-users

    Lists workspace members.

Workflows

Example workflows

From meeting to tasks

  1. 1

    Share the meeting notes page.

  2. 2

    The assistant reads it.

  3. 3

    It extracts actions with owners and dates.

  4. 4

    It creates tasks in the project database.

  5. 5

    It links them back to the notes.

Answer a policy question

  1. 1

    Ask about a policy.

  2. 2

    The assistant searches the wiki.

  3. 3

    It reads the relevant page.

  4. 4

    It answers with a link.

  5. 5

    You check the source.

Prompts

Example prompts

  • “Turn the notes from today's product meeting into tasks in the Roadmap database.”

  • “What is our policy on working from abroad? Link the page.”

  • “Draft a project brief page for the website redesign from this summary.”

Setup

Installation and configuration

Examples for Claude Desktop and Claude Code. Replace the placeholder values with your own keys, and store secrets outside version control.

Claude Desktop: claude_desktop_config.json

{
    "mcpServers": {
        "notion": {
            "url": "https://mcp.notion.com/mcp"
        }
    }
}

Claude Code: terminal

claude mcp add --transport http notion https://mcp.notion.com/mcp
  • Hosted server: https://mcp.notion.com/mcp (SSE fallback: https://mcp.notion.com/sse).
  • Local server: npx -y @notionhq/notion-mcp-server (no longer actively maintained).
  • Needs: OAuth (interactive). The old local server used a NOTION_TOKEN integration token..

Security

Security considerations

  • Limit workspaces

    Connect with an account that sees only the workspaces or projects a task needs.

  • Mark AI-created items

    Use a label or naming rule so items created by the assistant are easy to spot and review.

  • Guard deletes

    Moves and page changes should be reviewed. Keep page history on.

  • Untrusted text

    Task descriptions and comments can contain misleading text. Treat them as data.

Related servers

Servers that pair well with it

Confluence

Atlassian's official Rovo MCP server lets AI search and read Confluence spaces and pages, create and edit content and add comments and labels.

Linear

Linear's official hosted MCP server lets AI find, create and update issues, projects and comments, with a read-only endpoint available.

Google Drive

Google's own Drive MCP server lets AI search, read and create files in Google Drive, with your Google Workspace sign-in.

Keep exploring

FAQ

Questions people ask us

Have a question that is not here? Ask us directly.

Start a project

Want this connected to your own systems? We build AI workflows with MCP.

Send a short brief. We reply with questions, a suggested plan and an estimate you can compare with other offers.

Your privacy choices

We use necessary storage to run this site. With your permission we also use Google Analytics to see which pages help people, and load maps from Google. You can change this at any time. Read the cookie policy.