ノーションMCP
Notion の API と統合して個人の ToDo リストを管理するシンプルな Model Context Protocol (MCP) サーバー。
デモ
Related MCP server: Notion MCP Server
ビジュアルガイド
Notion MCP クエリ 1
Notion MCP クエリ 2
Notion MCP クエリ 3
前提条件
Python 3.11以上
APIアクセス可能なNotionアカウント
Notion統合トークン
ToDoリストを管理したいNotionページ
クロード・デスクトップ・クリント
設定
Smithery経由でインストール
Smithery経由で Claude Desktop 用の Notion MCP を自動的にインストールするには:
npx -y @smithery/cli install @Badhansen/notion-mcp --client claudeリポジトリをクローンします。
git clone https://github.com/Badhansen/notion-mcp.git
cd notion-mcpPython 環境をセットアップします。
uv venv
source .venv/bin/activate
uv pip install -e .Notion 統合を作成します。
https://www.notion.so/my-integrationsにアクセスしてください。
新しい統合を作成する
APIキーをコピーする
統合によりデータベース/ページを共有します:
データベース/テーブルまたはページが存在する Notion ワークスペースを開きます。
「…」メニュー→「接続を追加」をクリック
統合を選択してください（名前で検索）
構成
.envファイルを作成します:
cp .env.example .env.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"Claude Desktopで意図したとおりに使用するには、
claude_desktop_config.jsonファイルを調整する必要があります。ClaudeClaude 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"
}
}貢献
リポジトリをフォークする
機能ブランチを作成する
プルリクエストを送信する
ライセンス
MITライセンス。詳細はLICENSEファイルを参照してください。