Notion MCP

🚀 Notion と統合された MCP サーバー

これは、Notion の API を統合したシンプルな Model Context Protocol (MCP) サーバーです。Claude を通じて個人のタスクリストを管理するために使用されます。この実装は、私の極簡主義なタスクリストに特化しています。

🚀 クイックスタート

このサーバーは、特定の Notion データベース構造と連携して、Claude を通じてタスクの管理を行います。以下の手順に従ってセットアップしてください。

✨ 主な機能

• 新しいタスクを追加する
• すべてのタスクを表示する
• 今日のタスクを表示する
• タスクを完了としてマークする

📦 インストール

前提条件

• 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  # Windows の場合は：.venv\Scripts\activate
pip install -e .

3. Notion の統合を作成します。

   • https://www.notion.so/my-integrations にアクセスします。
   • 新しい統合を作成します。
   • API キーをコピーします。

4. 統合をデータベースと共有します。

   • タスクデータベースを開きます。
   • メニューの "..." → "接続を追加" をクリックします。
   • 作成した統合を選択します。

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"
    }
  }
}

💻 使用例

基本的な使用法

Claude を通じて以下の基本コマンドを使用できます。

• "すべてのタスクを表示"
• "今日のタスクは何ですか？"
• "今日のタスクとして、メールを確認する"
• "後で行うタスクとして、プロジェクトをレビューする"

サーバーの実行方法

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

1. コマンドラインから直接実行する。

# プロジェクトディレクトリで仮想環境をアクティブ化した後
python -m notion_mcp

2. Claude Desktop を通じて自動実行する（推奨）。

• claude_desktop_config.json で正しく設定すると、Claude 起動時に自動でサーバーが起動します。
• 手動でサーバーを管理する必要はありません。
• Claude を閉じると、サーバーも停止します。

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

📚 ドキュメント

制限事項

• 特定の Notion データベース構造でのみ使用できます。
• 複雑なデータベース構造には対応していません。
• タスクの予定は "今日" または "後で" のみサポートしています。
• 他の属性やカスタムフィールドはサポートしていません。
• 基本的なエラー処理のみです。
• 繰り返しタスク、優先度、タグなどの高度な機能はありません。

カスタマイズ

異なるデータベース構造を使用する場合は、server.py ファイルを修正してください。特に以下の部分を変更します。

• create_todo() 関数をデータベースの属性に合わせる。
• call_tool() 内のタスクのフォーマットをデータ構造に合わせる。
• list_tools() 内の入力パターンを変更する場合は、異なるオプションを設定する。

プロジェクト構造

notion_mcp/
├── pyproject.toml
├── README.md
├── .env                   # リポジトリには含まれません
└── src/
    └── notion_mcp/
        ├── __init__.py
        ├── __main__.py
        └── server.py      # メインの実装ファイル

📄 ライセンス

[ここにライセンス情報を挿入してください。例：MIT ライセンスまたはその他適用可能なライセンス]

貢献者

[貢献者の名前または GitHub ユーザー名を記載]

注意事項

このプロジェクトは特定のニーズに合わせて設計されています。他のニーズがある場合は、具体的な状況に合わせて調整してください。

⚠️ 重要提示

このプロジェクトは特定のユースケース（私のシンプルな Notion タスクリスト）を対象としています。このリストは 3 つの属性のみを持ちます。

• タスク（タイトル）
• 時間（選択肢は "今日" または "後で" の 2 つ）
• チェックボックス（完了済みをマーク）

Notion データベースの例

このコードを自分の Notion 統合の起点として使用することはできますが、データベース構造や要件に合わせて変更する必要がある場合があります。