Notion MCP Advanced

🚀 Notion MCP 統合

このプロジェクトは、Model Context Protocol (MCP) サーバーを Notion API と統合し、Claude を通じて個人のタスクリストを管理するためのシンプルな実装です。この実装は、minimalist な Notion のタスクリストに特化しています。

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

🚀 クイックスタート

このプロジェクトは、特定のユースケース、つまりシンプルな Notion のタスクリストを管理するために設計された個人用のプロジェクトです。以下の手順でセットアップし、タスク管理を始めることができます。

✨ 主な機能

• 説明とリンク付きの新しいタスクを追加する
• すべてのタスクを表示する
• タスクを完了としてマークする
• 外部リソースをタスクにリンクする

📦 インストール

前提条件

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

💻 使用例

基本的な使用法

サーバーの起動

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

1. コマンドラインから直接起動する：

# プロジェクトディレクトリで、仮想環境がアクティブな状態で
python -m notion_mcp

2. Claude Desktop を通じて自動起動する（推奨）：

• 正しく設定されていれば、Claude を起動するとサーバーも自動的に起動します。
• 詳細は Claude Documentation を参照してください。

タスクの管理

• Notion でタスクを含むデータベースを作成し、.env の設定と一致することを確認します。
• サーバーを起動した後、Claude を通じて MCP インターフェースを呼び出してタスクを管理します。

📚 ドキュメント

重要事項

• このプロジェクトは特定の Notion のタスクリスト用に設計されており、以下の 4 つの属性を持つデータベースを想定しています。

  • タスク（タイトル）
  • チェックボックス（完了済みをマーク）
  • 説明（追加の詳細）
  • リンク（URL または参照） Notion データベースの例

• このプロジェクトを起点に Notion 統合を始めることはできますが、データベースの構造や要件に合わせてコードを修正する必要があるかもしれません。

注意事項

• このプロジェクトは現在、基本的な CRUD 操作のみをサポートしています。
• 必要に応じて機能を拡張してください。
• エラーや問題が発生した場合は、ログを確認するか、設定を見直してください。

プロジェクト構造

notion-mcp/
├── server.py       # メインサーバーファイル
├── config.py      # 設定と環境変数
└── README.md      # プロジェクトドキュメント

この Notion MCP 統合をご利用いただき、ありがとうございます！何か問題や提案があれば、お気軽にご連絡ください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。