Notion MCP サーバー

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

特徴

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

インストール

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

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 にログ出力せずに実行されていることを確認してください。

謝辞

Claude Desktop やその他の MCP クライアントと連携するように構築されています
NotionのAPIを使用（最新の互換バージョン2022-02-22）
MCP 1.6.0 との互換性を維持
danhilseさんに特別な感謝を申し上げます。私は彼のnotion-mcp-serverプロジェクトを参考にしました。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Notion の API と対話するための標準化されたインターフェースを提供するモデルコンテキストプロトコルサーバー。これにより、ユーザーはデータベースの一覧表示、ページの作成、および Notion ワークスペース全体の検索を実行できます。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Notion MCP
Badhansen
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
Last updated -
13
Python
MIT License
Notion MCP Server
SAhmadUmass
-
security
F
license
-
quality
A Model Context Protocol server that enables Claude and other LLMs to interact with Notion workspaces, providing capabilities like searching, retrieving, creating and updating pages, as well as managing databases.
Last updated -
194
2
TypeScript
ConnectWise API Gateway MCP Server
jasondsmith72
-
security
F
license
-
quality
A Model Context Protocol server that provides a comprehensive interface for interacting with the ConnectWise Manage API, simplifying API discovery, execution, and management for both developers and AI assistants.
Last updated -
46
2
Python
Notion MCP Server
emmanuelsystems
A
security
F
license
A
quality
A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
Last updated -
12
194
JavaScript

View all related MCP servers

Notion MCP Server