Notion MCP Server

What it does

This project implements an MCP server for the Notion API. The README notes that for the best experience, use Remote Notion MCP, the official hosted MCP server, and that this repository is a separate, self-hosted MCP server implementation that is no longer actively maintained or supported. Remote Notion MCP can search a workspace and connected apps semantically, read and edit pages in Markdown, and uses OAuth while respecting each user existing Notion permissions, per the README comparison table.

The local server is at version 2.0.0, which migrates to Notion API 2025-09-03 with data sources as the primary abstraction for databases, for a total of 22 tools. It exposes two page-content tools, retrieve-page-markdown and update-page-markdown, for working with page content as enhanced Markdown instead of block JSON. Installation requires creating an internal integration in Notion, connecting content to the integration, and adding the MCP config to the client.

Configuration

npm: npx -y @notionhq/notion-mcp-server with NOTION_TOKEN env (recommended) after creating an internal integration at notion.so/profile/integrations and connecting pages or databases to it. Docker: official image mcp/notion with NOTION_TOKEN env. Transports are STDIO by default and Streamable HTTP, per README outline.

{"mcpServers":{"notionApi":{"command":"npx","args":["-y","@notionhq/notion-mcp-server"],"env":{"NOTION_TOKEN":"ntn_****"}}}}

Source: https://github.com/makenotion/notion-mcp-server. Placeholders only. Replace them in your own environment, and never commit real keys to a repository.

Verified tools and features

• query-data-source Config checked

  Query a data source (database) with filters and sorts. New tool in v2.0.0 replacing post-database-query, per README.

• retrieve-a-data-source Config checked

  Get metadata and schema for a data source. New tool in v2.0.0, per README.

• create-a-data-source Config checked

  Create a new data source. New tool in v2.0.0 replacing create-a-database, per README.

• update-a-data-source Config checked

  Update data source properties. New tool in v2.0.0 replacing update-a-database, per README.

• retrieve-page-markdown Config checked

  Read a page full content as Markdown, with include_transcript option to inline meeting-note transcripts, per README.

• update-page-markdown Config checked

  Edit a page content with Markdown, preferring replace_content to overwrite or update_content for targeted find-and-replace edits, per README.

• move-page Config checked

  Move a page to a different parent location. New tool in v2.0.0, per README.

Security notes