Wise Owl

Wise Owl MCP 服务

Wise Owl 是软件工程师的每日待办清单：记下当天的代码审查、临时打断和琐事，没完成的事项会自动移到明天。它的 MCP 服务允许 Claude、ChatGPT、Cursor、VS Code 或任何 MCP 客户端读取和更新你的清单。你可以用日常语言提问：“这周还有哪些事项未完成？”“把这个 PR 的后续事项加到明天”“规划我的一天”。

https://api.wiseowl.cat/mcp

这是一个远程服务（Streamable HTTP）：无需安装或运行任何东西。此仓库仅包含相关文档；服务本身并非开源。

每种助手的设置说明都有英文、加泰罗尼亚文和西班牙文版本，也可在 wiseowl.cat/en/connect 查看。

你需要一个账户

助手使用 Wise Owl 账户同步的清单，因此你需要一个免费账户：在 wiseowl.cat 注册。没有账户时，Wise Owl 仍可在浏览器中使用，但你的清单不会离开浏览器，因此助手无法访问。

设置

Claude 和 ChatGPT 使用 OAuth 登录：它们只需要地址，你登录 Wise Owl 并授权即可，无需复制密钥。对于 Claude Code、Cursor、VS Code、Windsurf 和其他客户端，创建访问令牌，并将其与地址一起添加。

Claude（网页和桌面版）

1. 在 Claude 中，打开 Settings → Connectors，然后添加自定义连接器。
2. 粘贴 Wise Owl 的地址：https://api.wiseowl.cat/mcp
3. 登录 Wise Owl 并授权访问。无需复制密钥：这是 OAuth。

Claude 桌面应用的操作步骤相同。

ChatGPT

ChatGPT 使用同一地址进行连接：添加一个使用该地址的自定义连接器，然后登录 Wise Owl 并授权。

创建访问令牌

Claude Code、Cursor、VS Code 和 Windsurf 使用令牌连接：

1. 登录 Wise Owl，然后打开 User configuration → Connected assistants。
2. 输入助手的名称，然后点击 Create token。
3. 立即复制以 wo_pat_ 开头的令牌：它之后不会再次显示。令牌可以读取和更改你的任务，并会在 90 天后过期。

请像对待密码一样保管令牌，不要将其放入提交的文件中。在以下示例中，将 wo_pat_… 替换为你的令牌。

Claude Code

claude mcp add --transport http wiseowl https://api.wiseowl.cat/mcp --header "Authorization: Bearer wo_pat_…"

创建令牌时，Wise Owl 会显示一条已包含令牌的命令。

Cursor

若要在每个项目中添加 Wise Owl，请将其添加到 ~/.cursor/mcp.json；若只在一个项目中添加，则添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "wiseowl": {
      "url": "https://api.wiseowl.cat/mcp",
      "headers": { "Authorization": "Bearer wo_pat_…" }
    }
  }
}

VS Code

将 Wise Owl 添加到项目中的 .vscode/mcp.json，或添加到用户配置（在命令面板中选择 MCP: Open User Configuration）。VS Code 会在服务首次启动时询问令牌，因此令牌不会写入文件：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "wiseowl-token",
      "description": "Wise Owl access token",
      "password": true
    }
  ],
  "servers": {
    "wiseowl": {
      "type": "http",
      "url": "https://api.wiseowl.cat/mcp",
      "headers": { "Authorization": "Bearer ${input:wiseowl-token}" }
    }
  }
}

Windsurf

Windsurf 现称为 Devin Desktop，它从 mcp_config.json 读取 MCP 服务。在该文件中添加 Wise Owl：

{
  "mcpServers": {
    "wiseowl": {
      "serverUrl": "https://api.wiseowl.cat/mcp",
      "headers": { "Authorization": "Bearer wo_pat_…" }
    }
  }
}

其他 MCP 客户端

任何支持 Streamable HTTP 的客户端都可以连接：提供地址；如果客户端无法通过 OAuth 登录，则提供包含令牌的 Authorization: Bearer wo_pat_… 标头。

工具

这些工具遵循与应用相同的规则：未完成的任务会延续到今天，每个看板（单独的列表，例如“工作”和“个人”）都有自己的日期。除非助手指定某个看板，否则读取工具会涵盖所有看板。日期格式为 YYYY-MM-DD，也可以使用 today / tomorrow / yesterday，时区为你的时区。

读取

工具	功能
list_boards	列出你的看板，以及每个看板今天有多少项未完成任务。
get_day	获取某一天的任务、状态，以及每项任务被延续的次数。首次打开今天的任务时，会像应用一样将未完成的任务延续过来。在 Claude 中，这一天会显示为列表，你可以直接在聊天中勾选任务。
list_days	列出最多 31 天范围内的任务。
search_tasks	按任务文本查找任务，也可以按状态或两个日期之间的范围筛选。
get_stale_tasks	获取不断被延续的未完成任务：这些任务可以现在完成、拆分或放弃。
get_summary	汇总最多 92 天内已完成、已延续、已放弃或仍未完成的任务数量，提供总计和每日统计。

写入

工具	功能
add_tasks	一次最多添加 50 项任务，可添加到今天或之后的某一天，并指定看板。
set_status	将任务标记为已完成、重新设为未完成、不打算完成或延续到次日。
edit_task	改写任务文本。
move_task	将未完成的任务安排到其他日期，就像在应用中推迟任务一样。
delete_task	从任务所在的每一天删除该任务。此操作被标记为破坏性操作，因此行为得当的助手会先征求你的同意。

提示词

提示词	功能
plan_my_day	查看今天的任务和不断被延续的任务，并提出计划；在你同意之前不会进行任何更改。
weekly_review	回顾过去七天：你完成了什么、哪些任务不断被延续，以及可以做哪些调整。不会更改任何任务。

权限

共有两种权限，也称为范围：

• tasks:read：读取你的任务和日期。
• tasks:write：添加、更改、移动和删除你的任务。

通过 OAuth 连接助手时，Wise Owl 会显示助手请求的权限，由你决定允许或拒绝。访问令牌包含这两种权限。

助手只能读取和更改任务，不能访问其他内容：包括你的密码、账户或账单。你的设置中会列出每个助手添加、改写、移动或删除的内容，并在每项更改旁提供“撤销”选项。

撤销访问权限

在 Wise Owl 中，打开 用户设置 → 已连接的助手。点击通过 OAuth 连接的助手旁的 断开连接，或访问令牌旁的 撤销。访问权限会立即失效；断开连接的助手若要重新连接，必须再次征求你的同意。删除账户会撤销所有访问权限。

在助手的设置中移除 Wise Owl，并不会自动撤销其访问权限：你也需要在 Wise Owl 中进行操作。

隐私

• 助手会看到它读取的任务文本，AI 提供商会根据自身条款处理这些文本。只连接你信任其处理这些内容的助手。
• Wise Owl 的日志会记录助手调用了哪个工具、耗时多久以及是否成功，但绝不会记录参数或回复，因为其中包含你的任务文本。设置中的更改列表会保留每个助手所做的更改，方便你撤销。
• 无需账户时，你的任务会保存在浏览器的本地存储中，不会发送到 Wise Owl 的服务器。

完整政策请访问 wiseowl.cat/en/privacy-policy。

链接

• 各助手的连接方法：https://wiseowl.cat/en/connect/
• Wise Owl：https://wiseowl.cat/
• 反馈与支持：[email protected]

许可证

此代码库中的文档采用 MIT License 许可。