Notion任务管理服务器

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

  • by bobbyhyam
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 bobbbino/ultimate-brain-mcp

使用说明

终极大脑MCP服务器

用于管理Thomas Frank的终极大脑概念系统的MCP服务器。使用PARA方法为任务、项目、注释、标签和目标提供30个面向工作流的工具,以及 daily_review_snapshot 整合器,在一次通话中返回每日审查所需的一切。

设置

  1. 创造一个 概念整合 并与它共享您的终极大脑数据库。

  2. 运行客户端的setup命令。它将从Notion自动发现您的数据源并写入配置文件。

Claude 代码

# Project scope (writes .mcp.json in current directory)
uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-code --scope project

# User scope (writes ~/.claude.json)
uvx --from ultimate-brain-mcp ultimate-brain-setup --client claude-code --scope user

Claude 桌面版

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

您还可以通过环境变量传递Notion secret以跳过提示:

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

工具

任务(6)

  • search_tasks --按名称、状态、项目、优先级、截止日期筛选(due_on 一天)、我的一天、标签、父任务、完成日期
  • create_task --创建名称、状态、到期时间、优先级、项目、标签、tag_ids、位置
  • update_task --修补任何任务属性(包括tag_ids和位置)
  • 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 --补丁目标属性

横切(3)

  • daily_summary --我的一天、过期、收件箱、活动项目/目标(仅计数)
  • archive_item --存档任何UB项目
  • set_page_content --替换或附加页面正文内容(markdown→ 块)

工作流整合器(2)

  • daily_review_snapshot --一个调用返回当前时间+IANA时区、所有五个每日审核桶(今天完成、今天逾期或到期、明天到期、我的一天、收件箱)、已消除重复的未完成联合、项目+区域标签查找表和实时任务模式(位置属性类型、有效选项、标签选项)。替换约7个单独的读取调用。
  • bulk_update_tasks --对每行结果同时应用多个任务补丁。从不在单个失败时引发-通过结果列表显示每个失败的行,以便调用者可以重试或跳过。

通用(4)

  • query_database --查询任何辅助数据库
  • get_page --按ID获取任何页面
  • get_page_content --页面属性加正文为纯文本
  • update_page --更新任何页面属性

配置

设置这些 .env (或通过MCP客户端配置传递):

变量 必需 目的
NOTION_INTEGRATION_SECRET 是 通知集成令牌
UB_TASKS_DS_ID, UB_PROJECTS_DS_ID, UB_NOTES_DS_ID, UB_TAGS_DS_ID, UB_GOALS_DS_ID 是 主数据源ID
UB_TIMEZONE 可选 IANA名称(例如。 Europe/London).被...使用 daily_review_snapshot 解决 now/today/tomorrow.回落到 TZ那么 UTC.
UB_*_DS_ID (工作会议、书籍等) 可选 通过 query_database
UB_TRANSPORT 可选 stdio (默认)或 streamable-http
UB_HOST, UB_PORT 可选 绑定地址 streamable-http (默认值 127.0.0.1:8000;容器图像默认为 0.0.0.0:8000)

码头工人

默认情况下,容器映像在端口8000上提供可流式传输的http:

docker run --rm -p 8000:8000 --env-file .env ghcr.io/bobbyhyam/ultimate-brain-mcp:latest

将任何可流式传输的http MCP客户端指向 http://localhost:8000/mcp.对于a stdio客户端,重写传输:

docker run --rm -i --env-file .env -e UB_TRANSPORT=stdio ghcr.io/bobbyhyam/ultimate-brain-mcp:latest

每次发布时都会发布图像,并标记 X.Y.Z, X.Y,以及 latest.

发展

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

贡献

欢迎捐款——见 贡献.md 开发设置和指南,以及 更改日志.md 发布历史。