awkoy/notion-mcp-server
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
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への読み書きアクセスを1トークンで提供します。AIはページ検索、作成、編集、データベースのクエリ、コメントやアップロードを平易な言語で行えます。
- すべてのNotionプランでトークン認証(無料含む)。 ブラウザサインインはなく、ヘッドレスで動作します:CI、cronジョブ、バックグラウンドエージェント、そして自社サーバーでも。
- 文脈を軽く扱う。 3つのツールは接続時に1,005トークンのコストがかかるのに対し、Notionのオープンソースサーバーは17,163トークンで、ページ閲覧数は82%少なくなっています。ベンチマーク→
- エージェント向けに構築されています。 バッチ処理はアトミックロールバックキーや冪等キー、レート制限の再試行、マークダウンの入出力、そしてモデルに呼び方を指示するエラーを使います。
クイックスタート
1.Notionトークンを取得してください。 app.notion.com/developers/tokens* → + 新しいトークン 名前を→、ワークスペースを選択し→てください トークンを作成 ntn_…の値をコピー→Personal Access Tokenは、ページごとの共有なしに、あなたが見えるすべてのものを閲覧できます。作成できないのですか?他のトークンオプションをご覧ください。
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
--envflag. Without it the entry is written without a token, and every call fails with an auth error.
Or install in one click:
インストール
npx -y notion-mcp-server設定
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "notion-mcp-server"],
"env": { "NOTION_TOKEN": "ntn_paste_your_token_here" }
}
}
}