awkoy/notion-mcp-server

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

179 stars 41 forks 质量 92 趋势 37MIT

Repository Install

awkoy/notion-mcp-server 是从 https://github.com/awkoy/notion-mcp-server. 导入的 MCP 服务器候选

概览

awkoy/notion-mcp-server 是从 https://github.com/awkoy/notion-mcp-server. 导入的 MCP 服务器候选

概述（AI 翻译）

notion-mcp-server 是一个模型上下文协议（MCP）服务器，提供 Claude Code、Claude Desktop、Cursor、VS Code、Codex 及任何其他 MCP 客户端对 Notion 的读写权限，只需一个令牌即可。你的 AI 可以用通俗语言搜索、创建和编辑页面、查询数据库、评论和上传文件。

所有 Notion 计划均支持令牌认证，包含免费。 无浏览器登录，因此它也无头运行：在 CI、cron 作业、后台代理以及你自己的服务器上。
上下文不足。 其三项工具连接成本为1,005令牌，而Notion的开源服务器需17,163令牌，页面读取量减少了82%。基准→
为代理构建。 批量写入使用原子回滚和幂等键，重试速率限制，输入和输出，以及错误指示模型如何修复调用。

快速开始

1.获取一个 Notion 令牌。 打开 app.notion.com/developers/tokens → + 新令牌 →命名，选择你的工作区 → 创建令牌 →复制 ntn_… 值。个人访问令牌能看到你能看到的所有内容，没有每页共享。不能创建一个吗？请查看另一个令牌选项。

2.安装它。

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Notion MCP Server — Connect Claude, Cursor, VS Code & Codex to Notion

notion-mcp-server is a Model Context Protocol (MCP) server that gives Claude Code, Claude Desktop, Cursor, VS Code, Codex and any other MCP client read/write access to Notion with one token. Your AI can search, create and edit pages, query databases, comment and upload files, in plain language.

Token auth on every Notion plan, Free included. No browser sign-in, so it also runs headless: in CI, cron jobs, background agents and on your own server.
Light on context. Its three tools cost 1,005 tokens at connection, against 17,163 for Notion’s open-source server, and page reads come back 82% smaller. Benchmark →
Built for agents. Batched writes with atomic rollback and idempotency keys, retry on rate limits, markdown in and out, and errors that tell the model how to fix the call.

Quick start

1. Get a Notion token. Open app.notion.com/developers/tokens → + New token → name it, pick your workspace → Create token → copy the ntn_… value. A Personal Access Token sees everything you can see, with no per-page sharing. Can’t create one? See the other token option.

2. Install it.

npx add-mcp notion-mcp-server --env NOTION_TOKEN=ntn_paste_your_token_here

add-mcp finds the MCP clients on your machine and writes the config for the ones you pick: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Gemini CLI, Cline, Windsurf, Zed and more. Add -g to install for your user instead of the current project.

Keep the --env flag. Without it the entry is written without a token, and every call fails with an auth error.

Or install in one click:

在 GitHub 查看完整 README

安装

npx -y notion-mcp-server

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "notion-mcp-server"],
      "env": { "NOTION_TOKEN": "ntn_paste_your_token_here" }
    }
  }
}