notion-mcp

notion-mcp

Notion の API と連携して個人の ToDo リストを管理する、シンプルな Model Context Protocol（MCP）サーバーです。

デモ

ビジュアルガイド

Notion MCP クエリ 1

Notion MCP クエリ 2

Notion MCP クエリ 3

前提条件

• Python 3.11 以上
• API アクセスが可能な Notion アカウント
• Notion インテグレーショントークン
• ToDo リストを管理したい Notion ページ
• Claude Desktop クライアント

セットアップ

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用の Notion MCP を自動的にインストールするには、次のコマンドを実行します:

npx -y @smithery/cli install @Badhansen/notion-mcp --client claude

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

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

2. Python 環境をセットアップします:

uv venv
source .venv/bin/activate
uv pip install -e .

3. Notion インテグレーションを作成します:
   • https://www.notion.so/my-integrations にアクセスします
   • 新しいインテグレーションを作成します
   • API キーをコピーします
4. データベースまたはページをインテグレーションと共有します:
   • データベースまたはテーブル、あるいはページが存在する Notion ワークスペースを開きます
   • 「...」メニューをクリック → 「コネクションを追加」を選択します
   • インテグレーションを選択します（名前で検索）

設定

1. .env ファイルを作成します:

cp .env.example .env

2. .env に Notion の認証情報を設定します:

NOTION_TOKEN=<your-notion-api-token>
PAGE_ID=<your-notion-page-id>
NOTION_VERSION="2022-06-28"
NOTION_BASE_URL="https://api.notion.com/v1"

3. 意図したとおりに Claude Desktop で使用するには、claude_desktop_config.json ファイルを調整する必要があります。 Claude Desktop -> Settings -> Developer -> Edit Config に進みます。次に、Notion サーバーの設定を追加します。

{
    "mcpServers": {
        "notion-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/username/Projects/Python/notion-mcp/src" /* Path to your project */,
                "run",
                "server.py"
            ]
        }
    }
}

開発

プロジェクト構成:

notion-mcp/
├── docs/
├── src/
│ └── server.py
├── .env
├── .python-version
├── README.md
├── pyproject.toml
└── uv.lock

サポート関数

タスクを表示

Notion ワークスペースからすべてのタスクを表示するには、show_all_todos 関数を使用します:

{
    "name": "show_all_todos",
    "arguments": {}
}

タスクを追加

Notion ワークスペースに新しいタスクを追加するには、add_todo 関数を使用します:

{
    "name": "add_todo",
    "arguments": {
        "task": "Your task description"
    }
}

タスクを更新

Notion ワークスペースの既存のタスクを更新するには、complete_todo 関数を使用します:

{
    "name": "complete_todo",
    "arguments": {
        "task_id": "your-task-id"
    }
}

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. プルリクエストを送信します

ライセンス

MIT ライセンス。詳細については、LICENSE ファイルを参照してください。