Notion MCP サーバー

Notion統合のためのモデルコンテキストプロトコル（MCP）サーバー実装。Notion APIとの連携のための標準化されたインターフェースを提供します。Claude Desktopおよびその他のMCPクライアントと互換性があります。

特徴

Notionデータベースの一覧表示とクエリ
ページの作成と更新
Notionワークスペース全体を検索
データベースの詳細を取得し、子をブロックする
httpx による完全な async/await サポート
Pydantic v2 モデルによる型安全
詳細なログ記録による適切なエラー処理
MCP 1.6.0との互換性

Related MCP server: Notion MCP Server

インストール

リポジトリをクローンします。

git clone https://github.com/ccabanillas/notion-mcp.git cd notion-mcp

仮想環境を作成し、依存関係をインストールします (uv を使用)。

uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -e .

あるいは、標準の venv を使用します。

python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -e .

プロジェクトルートに.envファイルを作成します。

NOTION_API_KEY=your_notion_integration_token

使用法

サーバーをテストします (エラーなしで実行されるはずです)。

python -m notion_mcp

Claude Desktop で使用するには、 claude_desktop_config.jsonファイル (macOS では~/Library/Application Support/Claude/claude_desktop_config.jsonにあります) を調整します。

{ "servers": { "notion-mcp": { "command": "/Users/username/Projects/notion-mcp/.venv/bin/python", "args": ["-m", "notion_mcp"], "cwd": "/Users/username/Projects/notion-mcp" } } }

/Users/username/実際のホームディレクトリパスに置き換えてください。

発達

プロジェクト構造

notion-mcp/ ├── src/ │ └── notion_mcp/ │ ├── models/ │ │ ├── __init__.py │ │ └── notion.py # Pydantic models for Notion objects │ ├── __init__.py │ ├── __main__.py # Entry point │ ├── client.py # Notion API client │ └── server.py # MCP server implementation ├── .env # Environment variables (add your Notion API key here) ├── .gitignore ├── pyproject.toml # Project dependencies └── README.md

テストの実行

pytest

構成

サーバーにはNotion統合トークンが必要です。設定方法は次のとおりです。

https://www.notion.so/my-integrationsにアクセスしてください。
適切な機能（必要に応じて読み取り/書き込み）を備えた新しい統合を作成します
統合トークンをコピーする
プロジェクトのルートディレクトリの.envファイルに追加します。

NOTION_API_KEY=your_notion_integration_token

Notionデータベースを統合して共有する（データベースの「共有」メニューから）

貢献

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

ライセンス

MITライセンス - 自己責任で使用してください

トラブルシューティング

よくある問題

接続エラー: Notion APIキーが正しいこと、インターネットにアクセスできることを確認してください
権限エラー: 統合に、アクセスしようとしているデータベースへのアクセス権が付与されていることを確認してください
Claude デスクトップ統合: Claude デスクトップが接続しない場合は、設定パスが正しいことと、サーバーが stdout にログ出力せずに実行されていることを確認してください。