Creativity · MCP — server

MCP Notion Server

The MCP Notion Server connects Claude Desktop or any MCP client to a Notion workspace through the public Notion API. Once you create a Notion internal integration and share a few pages with it, the server surfaces search, page read, database query, and block append tools — the simplest way to let an LLM agent live inside your team's Notion.

MCP facts

Kind: server
Ecosystem: anthropic-mcp
Language: TypeScript / Node.js
Transports: stdio, http

Capabilities

Tools: notion_search across all shared pages and databases
Tools: notion_retrieve_page, notion_update_page, notion_append_block_children
Tools: notion_query_database, notion_create_database_entry
Auth: Notion internal integration token, per-page sharing for least privilege

Install

npx -y @notionhq/notion-mcp-server

Configuration

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_API_KEY": "secret_xxx"
      }
    }
  }
}

Frequently asked questions

How do I give the MCP server access to a Notion page?

Create an internal integration at notion.so/my-integrations, copy the secret into NOTION_API_KEY, then in Notion open each page or database you want exposed, click … → Connections → add your integration. The server can only see pages it was explicitly shared with.

Does the server support writing rich Notion blocks?

Yes via append_block_children — you can post paragraphs, headings, code blocks, toggles, and callouts. Updating individual blocks is supported through block-level tools; large document rewrites are best done as new pages.

Is there a hosted Notion MCP endpoint?

Notion ships an official remote MCP endpoint with OAuth, so you can avoid running the stdio server locally. Most developers still use the npx flow for personal workspaces.

Sources

Notion MCP server (official) — accessed 2026-04-20
Notion API — integrations — accessed 2026-04-20