todoist mcp插件
一个Claude Code插件，将官方Todoist MCP服务器封装在一个子代理中，将工具定义排除在主上下文窗口之外。
在Claude Code中启用的每个MCP服务器都会将工具模式注入到系统提示符中——即使在空闲时，也会在每条消息中使用令牌。Todoist MCP增加了约2500个令牌的模式。此插件将它们隔离在一个子代理中，因此您只需在实际使用Todoist时付费。
建筑
┌─────────────────────────────────────────────────┐
│ Main Claude Code Conversation │
│ │
│ Skills loaded on demand: │
│ ┌─────────────┐ ┌──────────────┐ │
│ │todoist-tasks │ │ todoist-sync │ ~50-80 tok │
│ │ (metadata) │ │ (metadata) │ idle cost │
│ └──────┬──────┘ └──────┬───────┘ │
│ │ │ │
│ └───────┬────────┘ │
│ ▼ │
│ ┌──────────────────────────────┐ │
│ │ todoist-agent │ │
│ │ (separate context window) │ │
│ │ │ │
│ │ MCP tool definitions live │ │
│ │ HERE, not in main context │ │
│ │ │ │
│ │ ┌────────────────────────┐ │ │
│ │ │ Doist MCP (HTTP/OAuth) │ │ │
│ │ │ ai.todoist.net/mcp │ │ │
│ │ └────────────────────────┘ │ │
│ └──────────────────────────────┘ │
└─────────────────────────────────────────────────┘技能只向主上下文公开短元数据（~50-80个令牌）。当触发时，完整的技能体加载并委托给一个子代理，该子代理在其自己的上下文窗口中保存MCP连接。工具模式保持隔离。
代币成本比较
| 设置 | 空闲上下文成本 | 每次操作成本 |
|---|---|---|
| 原始MCP（始终加载） | ~2500个令牌/消息 | 相同+neneneba API响应 |
| 此插件 | ~50-80个令牌/消息 | ~900个令牌（技能体）+子代理 |
在一个50条消息的编码会话中，原始MCP在您两次使用的Todoist模式上花费了100k-150k个令牌。此插件仅在您使用时付费。
快速开始
claude plugin install /todoist-mcp-plugin然后使用Todoist MCP服务器进行身份验证：
- 启动克劳德代码
- 跑
/mcp - 选择
todoist服务器 - 完成基于浏览器的OAuth流程
没有API密钥需要管理——官方Doist服务器使用OAuth。
用法
自然语言，自动委托：
"Add a task 'Review PR #42' to Work with p2 priority due tomorrow"
"What's due today?"
"Mark the deploy task as done"
"Refresh my Todoist projects"支持的操作
- 任务CRUD --创建、完成、更新、删除
- 查询 --按项目、优先级、截止日期、标签或Todoist筛选器字符串
- 结构同步 --在对话中提取和缓存的项目、部分、标签
- 错误恢复 --名称解析失败时自动重新同步
设计原则
- 亚代理隔离 --MCP工具定义从不进入主上下文窗口
- 渐进式呈现 --技能元数据始终加载；仅在触发时提供完整指令
- 第一批 --所有MCP工具都接受阵列；该插件收集项目并进行单批处理调用
- 先缓存 --Todoist结构每个会话同步一次，跨操作重用
- 官方MCP --使用Doist自己的服务器(
ai.todoist.net/mcp)使用OAuth身份验证
需求
- 支持插件的Claude代码
- Todoist帐户（免费或专业版）
许可证
麻省理工学院