Taskpile.app

Taskpile MCP

Taskpile 的 Model Context Protocol 服务公开文档。

绝不忘记任何事。专注于当下。 Taskpile 是一款围绕两个动作打造的个人任务追踪工具：先堆起来，再整理。无论是通过 Claude、ChatGPT 或任何兼容 MCP 的客户端，还是在 taskpile.app 应用中，随时捕捉刚出现的任何事情。每天花两分钟回顾，就能把堆积的任务整理成一份简短的“今天”清单；其他事情则按顺序等待。

Taskpile 已收录在 Claude 连接器目录中。

• 应用：https://taskpile.app
• MCP 端点：https://taskpile.app/api/mcp
• 传输方式：Streamable HTTP (JSON-RPC 2.0)
• 支持的协议版本：2025-11-25、2025-06-18、2025-03-26、2024-11-05

本仓库仅包含面向公众的 MCP 集成文档。Taskpile 应用本身是托管式商业产品：其源代码不在此处，但连接客户端并使用 MCP 工具所需的一切内容都在这里。

连接

任何兼容 MCP 的客户端都可以通过连接上方的 URL 来使用。身份验证采用 OAuth 2.1，并使用 Dynamic Client Registration + PKCE。客户端会自动处理这些步骤；系统提示时，用户只需在浏览器标签页中登录 Taskpile。

已验证的客户端：

客户端	状态
Claude.ai (连接器)	✅
Claude Desktop (通过 mcp-remote)	✅
Claude Code	✅
ChatGPT (连接器)	✅
Le Chat (Mistral)	✅
Cursor	✅
Zed	✅
MCP Inspector	✅
Lovable.app	✅

按客户端快速开始

可在 examples/ 中查看可直接粘贴的配置片段：

• Claude Desktop
• Cursor
• Cline (VS Code)
• MCP Inspector

对于 Claude.ai 和 ChatGPT 这类托管客户端，可通过其内置连接器界面添加 Taskpile，并粘贴上方的 URL；无需本地配置。

工具

Taskpile 提供 72 个工具，涵盖任务 CRUD、项目、标签、颜色、搜索、批量操作、团队，以及晨间摘要和任务提醒等账户集成功能。完整的机器可读架构（名称、描述、输入和输出的 JSON Schema）位于 tools.json 中，由服务的工具架构生成。

tools/list 会根据账户定制，因此客户端通常看到的工具少于 72 个：用户加入团队后会显示团队管理工具；拥有共享项目后会显示项目成员工具；能够访问团队拥有的项目后会显示分配/分流工具；而 search/fetch 仅面向 OpenAI 客户端。隐藏的工具仍可调用；入口工具（create_team、convert_project_to_shared、invite_to_project、list_received_invitations、accept_invitation）始终会列出。

快速了解：

• create_task、list_tasks、update_task、complete_task、delete_task
• assign_horizon (today_morning、tomorrow、next_week 等)、delegate_task、set_recurrence
• list_projects、create_project、archive_project
• search_tasks（全文搜索 + 状态/时间范围筛选）
• bulk_complete、bulk_archive（可撤销，优先使用此工具，而非 bulk_delete）、bulk_delete、bulk_assign_horizon（每次调用最多 200 个 ID）
• changes_since（增量同步：不会报告删除项，因此请定期通过完整获取进行核对；每次调用最多返回 500 行）、get_today、get_review_queue
• list_closed_tasks（指定日期范围内已完成的任务）
• get_morning_digest、configure_morning_digest、get_task_reminders、configure_task_reminders
• list_colors、create_color、update_color、delete_color
• whoami、get_inbox_email
• 团队：create_team、invite_to_team、accept_invitation、assign_task、convert_project_to_shared 等
• search 和 fetch（ChatGPT Connectors 内置工具，映射到 Taskpile）

约定

如果你要编写提示词，以下是一些值得了解的项目级约定：

• 标签使用 @tag_name。项目使用 #project_name。 请勿使用 # 表示标签：#foo 会被静默地视为项目名称。
• create_task 会从标题中解析 #project 和 @tag 简写。只有第一个 # 标记会成为项目，其余标记都会被剥除。
• #name 会解析与你共享的项目，不仅限于你自己的项目。如果名称唯一，就会使用该项目；如果名称不唯一（例如，名称相同的私人项目和共享项目），调用会失败并返回候选列表：询问用户要选哪一个，然后使用明确的 projectId 重试。如果没有匹配项，则会创建一个归你所有的新项目。
• 创建时要设置标签，请传入 tags: string[]，和／或在标题中添加 @tag。两种方式都可用，且重复标签会被去重。
• update_task 不会从标题中解析 #／@ 简写。请使用 tags／addTags／removeTags 和 projectId 来更改这些内容。
• 如果有专用动词，请优先使用，而不是 update_task：complete_task、assign_horizon、delegate_task。
• 批量端点每次调用最多接受 200 个 ID。

认证流程

如果你正在构建客户端并想了解预期流程：

1. 客户端向 https://taskpile.app/api/mcp 发送未经身份验证的请求，并收到带有 WWW-Authenticate: Bearer realm="taskpile", resource_metadata="https://taskpile.app/.well-known/oauth-protected-resource" 的 401 响应。
2. 客户端获取 https://taskpile.app/.well-known/oauth-protected-resource 和 …/oauth-authorization-server，以发现端点。
3. 客户端向 https://taskpile.app/oauth/register 发送 POST 请求，进行动态客户端注册（RFC 7591）。
4. 客户端启动标准的授权码 + PKCE 流程，在 /oauth/authorize 打开浏览器，在 /oauth/token 交换授权码，并获取 access_token。
5. 后续请求需携带 Authorization: Bearer <token>。访问令牌有效期为 30 天。注册了 refresh_token 授权类型的客户端还会获得刷新令牌，有效期为 90 天，每次使用后都会轮换；其他客户端则在令牌过期时重新运行授权／令牌流程。可通过 /oauth/revoke 撤销令牌（RFC 7009）。

HEAD /api/mcp 无需身份验证即可返回 200，仅用于存活探测。

隐私与数据处理

• Taskpile 符合 GDPR。通过 MCP 创建的任务、项目和标签均归用户所有，且仅对通过身份验证的用户可见（共享项目的团队成员也可见）。
• MCP 集成会将任务内容发送至 Taskpile 的服务器（托管于欧盟）。内容不会经由 Anthropic、OpenAI 或任何其他大模型服务提供商：它们是 MCP 服务的客户端，而非服务本身。
• 可在 Taskpile → Settings → Integrations 中创建个人访问令牌，并可随时撤销。

问题与反馈

本仓库用于存放文档。如果你要报告 MCP 服务的 Bug、请求新增工具，或咨询 API，请在此处提交 issue，我们会进行分流处理。

如果你遇到 Taskpile 应用问题（与 MCP 无关），请通过应用 https://taskpile.app 联系我们。

许可证

本仓库中的文档采用 MIT 许可证授权（参见 LICENSE）。Taskpile 应用本身是托管式商业产品，不允许再分发。