Notion MCP

🚀 個人のタスクリスト用シンプルMCPサーバー（Notion統合）

Model Context Protocol (MCP) のシンプルなサーバーで、Notion API を統合して個人のタスクリストを管理します。

🚀 クイックスタート

デモ

ビジュアルガイド

Notion MCP クエリ 1

Notion MCP クエリ 2

Notion MCP クエリ 3

✨ 主な機能

• タスクの表示：すべてのタスクを一覧表示します。
• タスクの追加：新しいタスクを作成します。
• タスクの状態更新：タスクを完了としてマークします。

📦 インストール

前提条件

• Python 3.11 以上
• Notion アカウントと API アクセス権限
• Notion 統合トークン
• タスクを管理する Notion ページ
• Claude Desktop クライアント

インストール手順

Smithery を使用したインストール

Smithery を使用して 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=<あなたの Notion API トークン>
PAGE_ID=<あなたの Notion ページ ID>
NOTION_VERSION="2022-06-28"
NOTION_BASE_URL="https://api.notion.com/v1"

3. Claude Desktop と連携する場合は、claude_desktop_config.json ファイルを調整します。 Claude Desktop -> 設定 -> 開発者 -> 設定ファイル に移動して編集します。

{
  "mcpServers": {
    "notionMcp": {
      "url": "http://localhost:5000",
      "enabled": true
    }
  }
}

💻 使用例

基本的な使用法

すべてのタスクを表示

{
  "command": "listTasks"
}

新しいタスクを追加

{
  "command": "addTask",
  "task": "食料品を買う"
}

タスクを完了としてマーク

{
  "command": "completeTask",
  "taskId": "unique_task_id_123"
}

📚 ドキュメント

プロジェクト構造

notion-mcp/
├── server.py          # メインサーバーファイル
├── config.py         # 設定パラメータ
├── routes/           # ルート定義
│   ├── tasks.py      # タスク関連のルート
├── utils/            # ユーティリティ関数
│   ├── notion_utils.py  # Notion API ユーティリティ
└── README.md         # プロジェクトドキュメント

貢献ガイド

1. リポジトリを Fork する：GitHub でこのプロジェクトを Fork します。
2. ブランチを作成する：新しい機能や修正のためのブランチを作成します。
3. 変更をコミットする：変更をコミットし、詳細な説明を追加します。
4. リモートリポジトリに Push する。
5. Pull Request を開く：メインブランチに対してマージリクエストを提出します。

📄 ライセンス

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