Notion MCP Integration

Notion MCP Integration

Claude を通じて個人用の ToDo リストを管理するために、Notion の API と連携するシンプルな Model Context Protocol（MCP）サーバーです。Notion でのミニマルな ToDo リストの設定に合わせて、特別に調整された基本的な実装です。

このプロジェクトは danhilse/notion_mcp をベースにしており、MIT ライセンスの下で公開されています。

重要なお知らせ

これは、プロパティが 4 つだけのシンプルな Notion ToDo リストという、非常に限定された用途向けに設計された個人プロジェクトです。

• Task（タイトル）
• Checkbox（完了済みかどうかを示します）
• Description（追加の詳細）
• Link（URL または参照先）

Notion データベースの例

このプロジェクトを独自の Notion 連携の出発点として利用できますが、特定のデータベース構造や要件に合わせてコードを変更する必要があるでしょう。

機能

• 説明やリンクを付けて新しい ToDo 項目を追加
• すべての ToDo を表示
• タスクを完了済みにする
• 外部リソースをタスクにリンク

前提条件

• Python 3.10 以降
• Notion アカウント
• Notion インテグレーション（API キー）
• 上記と完全に一致する構造の Notion データベース（または、独自の構造に合わせてコードを変更する意思）

セットアップ

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

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

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

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

3. Notion インテグレーションを作成します：

   • https://www.notion.so/my-integrations にアクセスします
   • 新しいインテグレーションを作成します
   • API キーをコピーします

4. データベースをインテグレーションと共有します：

   • Notion で ToDo データベースを開きます
   • 「...」メニューをクリックし、「Add connections」を選択します
   • インテグレーションを選択します

5. .env ファイルを作成します：

NOTION_API_KEY=your-api-key-here
NOTION_DATABASE_ID=your-database-id-here

6. Claude Desktop を設定します：

{
  "mcpServers": {
    "notion-todo": {
      "command": "/path/to/your/.venv/bin/python",
      "args": ["-m", "notion_mcp"],
      "cwd": "/path/to/notion-mcp"
    }
  }
}

サーバーの実行

サーバーは 2 つの方法で実行できます。

1. コマンドラインから直接実行：

# From the project directory with virtual environment activated
python -m notion_mcp

2. Claude Desktop を通じて自動的に実行（推奨）：

• claude_desktop_config.json で正しく設定されていれば、Claude の起動時にサーバーが起動します
• 手動でサーバーを管理する必要はありません
• Claude を終了するとサーバーも停止します

注：直接実行した場合、エラーがない限りサーバーは何も出力しません。MCP コマンドを待機しているため、これは正常です。

使用方法

Claude を通じて実行する基本的なコマンド：

• 「ToDo をすべて表示して」
• 「ToDo を追加して：メールを確認」
• 「ToDo を追加して：プロジェクトのドキュメントを確認、リンク：https://example.com/docs」
• 「ToDo [ID] を完了済みにして」

制限事項

• 特定の Notion データベース構造でのみ動作します
• 複雑なデータベーススキーマには対応していません
• エラー処理は基本的なものです
• 追加のプロパティやカスタムフィールドには対応していません
• 繰り返しタスク、優先度、タグなどの高度な機能はありません

プロジェクト構成

notion_mcp/
├── pyproject.toml
├── README.md
├── .env                   # Not included in repo
└── src/
    └── notion_mcp/
        ├── __init__.py
        ├── __main__.py
        └── server.py      # Main implementation

ライセンス

MIT ライセンス — 自己責任でご利用ください

謝辞

• Claude Desktop で動作するように構築されています
• Notion の API を使用しています