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

インストール

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

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

2. 仮想環境を作成し、依存関係をインストールします (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 .

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

NOTION_API_KEY=your_notion_integration_token

使用法

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

python -m notion_mcp

2. 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統合トークンが必要です。設定方法は次のとおりです。

1. https://www.notion.so/my-integrationsにアクセスしてください。

2. 適切な機能（必要に応じて読み取り/書き込み）を備えた新しい統合を作成します

3. 統合トークンをコピーする

4. プロジェクトのルート ディレクトリの.envファイルに追加します。

NOTION_API_KEY=your_notion_integration_token

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

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く

ライセンス

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

トラブルシューティング

よくある問題

• 接続エラー: Notion APIキーが正しいこと、インターネットにアクセスできることを確認してください

• 権限エラー: 統合に、アクセスしようとしているデータベースへのアクセス権が付与されていることを確認してください

• Claude デスクトップ統合: Claude デスクトップが接続しない場合は、設定パスが正しいことと、サーバーが stdout にログ出力せずに実行されていることを確認してください。

謝辞

• Claude Desktop やその他の MCP クライアントと連携するように構築されています

• NotionのAPIを使用（最新の互換バージョン2022-02-22）

• MCP 1.6.0 との互換性を維持

• danhilseさんに特別な感謝を申し上げます。私は彼のnotion-mcp-serverプロジェクトを参考にしました。