Back to MCP directory
publicPublicdnsLocal runtime

ultimate-brain-mcp

一个用于管理Thomas Frank的Ultimate Brain Notion系统的MCP服务器,基于PARA方法论,提供任务、项目、笔记、标签和目标等26个工作流工具。

article

README

🚀 终极大脑MCP服务器

这是一个用于管理托马斯·弗兰克(Thomas Frank)的终极大脑Notion系统的MCP服务器。它运用PARA方法,为任务、项目、笔记、标签和目标提供了26个面向工作流的工具。

🚀 快速开始

步骤

  1. 创建一个 Notion集成,并将你的终极大脑数据库与之共享。
  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 — 按名称、状态、项目、优先级、截止日期、我的一天、标签、父任务、完成日期进行过滤
  • create_task — 使用名称、状态、截止日期、优先级、项目、标签创建任务
  • update_task — 修补任何任务属性
  • complete_task — 标记任务完成并处理重复任务
  • get_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 — 获取我的一天、逾期、收件箱、活跃项目/目标的摘要
  • archive_item — 存档任何终极大脑项目

通用工具(3个)

  • query_database — 查询任何二级数据库
  • get_page — 通过ID获取任何页面
  • update_page — 更新任何页面属性

📦 安装指南

开发环境设置

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client