Ultimate Brain MCP

🚀 Ultimate Brain用MCPサーバー

トーマス・フランクのUltimate Brain Notionシステムを管理するためのMCPサーバーです。PARA手法を用いて、タスク、プロジェクト、ノート、タグ、目標に関する26のワークフロー指向のツールを提供します。

🚀 クイックスタート

📦 インストール

1. Notionの統合設定を作成し、Ultimate Brainのデータベースをそれと共有します。
2. クライアント用のセットアップコマンドを実行します。これにより、Notionからデータソースが自動検出され、設定ファイルが書き込まれます。

Claude Code

# プロジェクトスコープ (カレントディレクトリに.mcp.jsonを書き込む)
uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-code --scope project

# ユーザースコープ (~/.claude.jsonを書き込む)
uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-code --scope user

Claude Desktop

uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-desktop

また、環境変数を介してNotionのシークレットを渡すことで、プロンプトをスキップすることもできます。

NOTION_INTEGRATION_SECRET=secret_... uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-code --scope project

✨ 主な機能

タスク (6)

• search_tasks — 名前、ステータス、プロジェクト、優先度、期限、My Day、ラベル、親タスク、完了日でフィルタリング
• create_task — 名前、ステータス、期限、優先度、プロジェクト、ラベルで作成
• update_task — 任意のタスクプロパティを更新
• complete_task — 繰り返し処理を伴う完了マーク
• get_my_day — 優先度でソートされたMy Dayのタスク
• get_inbox_tasks — トリアージが必要な未処理のタスク

プロジェクト (4)

• search_projects — ステータス、タグでフィルタリング
• get_project_detail — プロパティ + タスクの内訳 + 最近のノート
• create_project — 名前、ステータス、期限、タグ、目標で作成
• update_project — プロジェクトのプロパティを更新

ノート (4)

• search_notes — タイプ、プロジェクト、タグ、お気に入り、日付でフィルタリング
• get_note_content — プロパティ + ページ本文をプレーンテキストで取得
• create_note — タイプ、プロジェクト、タグ、URLで作成
• update_note — ノートのプロパティを更新

タグ (3)

• search_tags — PARAタイプでフィルタリング
• create_tag — 名前、タイプ、親で作成
• update_tag — タグのプロパティを更新

目標 (4)

• search_goals — ステータスでフィルタリング
• get_goal_detail — プロパティ + 関連するプロジェクト
• create_goal — 名前、ステータス、期限で作成
• update_goal — 目標のプロパティを更新

横断的な機能 (2)

• daily_summary — My Day、期限切れ、インボックス、アクティブなプロジェクト/目標の概要
• archive_item — 任意のUltimate Brainアイテムをアーカイブ

汎用的な機能 (3)

• query_database — 任意のセカンダリデータベースをクエリ
• get_page — IDで任意のページを取得
• update_page — 任意のページのプロパティを更新

🔧 開発

uv run pytest tests/
uv run mcp dev src/ultimate_brain_mcp/server.py