notion-mcp-server

Level ALocal

Official Notion MCP Server

Overview

Notion MCP Server is an MCP server implementation for the official Notion API, letting AI clients access and work with Notion workspaces. It offers 22 tools for querying data sources, creating and updating pages, and retrieving database metadata, plus Markdown-based page reading and editing that is more token-efficient than block JSON. Note: this self-hosted project is no longer actively maintained; Notion recommends the hosted Remote Notion MCP instead.

⭐ 4.7kOffice & ProductivityTypeScriptRepo ↗Updated 2026-10-29

Installation

MCP client config (paste into mcp.json)

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

Agent install prompt

Copy and paste into Cursor / Claude / other agents to install this MCP for you

Please read this MCP repository and install it into my current environment:
https://github.com/makenotion/notion-mcp-server

Known working client config (can write into mcp.json):
{
  "mcpServers": {
    "makenotion-notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Please: 1) check README for deps and env vars; 2) write config for my client; 3) if secrets are missing, tell me what to fill — do not invent values.

Related servers