Notion MCP Server

@ramidecodes

代码仓库

基本信息

分类

记忆与知识

许可证

Apache-2.0

传输方式

stdio

作者

ramidecodes

关于 Notion MCP Server

A Model Context Protocol server wrapping the official Notion SDK

Notion MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

Notion MCP Server 工具

Find pages or databases

Query and retrieve database entries

Create, retrieve, and update pages

Manage content blocks (paragraphs, lists, etc.)

List users and get user information

Create and list comments

概览

What is Notion MCP Server?

A Model Context Protocol (MCP) server that exposes the official Notion SDK, allowing AI models to interact with Notion workspaces. It enables AI assistants to search, read, and write Notion pages, databases, and other content.

How to use Notion MCP Server?

Set up a Notion integration at my-integrations, copy the API key, and share the desired pages/databases with that integration. Then run the server using npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key or configure it in Claude Desktop, Cursor AI, or Claude.ai via the JSON format shown in the README.

Key features of Notion MCP Server

Full Notion API support through the official SDK
MCP compliant for seamless AI integration
Tools for search, databases, pages, blocks, users, comments, and link previews
Robust error handling with detailed messages
Easy configuration with environment variables

Use cases of Notion MCP Server

AI assistants searching and retrieving Notion pages or databases
Creating and updating Notion pages programmatically
Managing content blocks such as paragraphs, lists, and headings
Listing users and getting their information
Adding comments or link previews to Notion content

常见问题

What does the server depend on?

It requires Node.js/npx to run and a Notion API key. The server uses the official Notion SDK.

How does the server authenticate with Notion?

It uses an integration API key passed via the `--api-key` command-line option or a `NOTION_API_KEY` environment variable.

Where does data live?

All data stays inside the connected Notion workspace. The server does not store any data; it only exposes the Notion API via MCP.

What are the main limitations?

The integration must be explicitly shared with each page or database it accesses. It only has access to pages/databases that have been shared with it. Also, the integration’s capabilities must be enabled in Notion settings.

What transport does the server use?

The server uses standard MCP transport (stdio) as an MCP server invoked via `npx`. No network transport is mentioned.

记忆与知识分类下的更多 MCP 服务器

HandbookHub MCP

veryayskiy

Search saved employee handbooks from your AI assistant. Four read-only tools list authorized handbooks, browse policies, search content, and read source pages with citation links. Uses scoped bearer tokens and Streamable