Skip to main content
Glama
enesjakozh

Notion MCP Server

by ccabanillas
GitHub
Python
MIT License
110
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Notion MCP サーバー

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

特徴

  • Notionデータベースの一覧表示とクエリ

  • ページの作成と更新

  • Notionワークスペース全体を検索

  • データベースの詳細を取得し、子をブロックする

  • httpx による完全な async/await サポート

  • Pydantic v2 モデルによる型安全

  • 詳細なログ記録による適切なエラー処理

  • MCP 1.6.0との互換性

インストール

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

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

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

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

NOTION_API_KEY=your_notion_integration_token

使用法

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

python -m notion_mcp

  1. 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

  1. 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プロジェクトを参考にしました。

This server cannot be installed

-
security - not tested
A
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 ワークスペース全体の検索を実行できます。

  1. 特徴
    1. インストール
      1. 使用法
        1. 発達
          1. プロジェクト構造
          2. テストの実行
        2. 構成
          1. 貢献
            1. ライセンス
              1. トラブルシューティング
                1. よくある問題
              2. 謝辞

                Related Resources

                Related MCP Servers

                • Notion MCP Server

                  SAhmadUmass
                  A
                  security
                  F
                  license
                  A
                  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 -
                  10
                  238
                  3

                • 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
                  238
                  1
                  • Apple

                • Notion MCP Server

                  ghubnerr
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that provides a standardized interface for AI models to access, query, and modify content in Notion workspaces.
                  Last updated -
                  238
                  4
                  MIT License
                  • Apple

                • NotionMCP Light

                  karaage0703
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that synchronizes Markdown files with Notion pages without using LLM tokens, enabling direct interaction with Notion databases and pages through API calls.
                  Last updated -
                  48
                  MIT License

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/ccabanillas/notion-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server