Todoist MCP 服务器
连接 AI 代理到 Todoist 的库 。 包括可纳入LLMS的工具, 以用户的名义访问和修改 Todoist 账户.
这些工具既可以通过MCP服务器使用,也可以直接从其他项目导入到 将它们集成到您的 AI 对话界面中 .
使用工具
1. 将此寄存器添加为依赖
npm install @doist/todoist-mcp
2. 进口工具并插入AI
举个例子 Vercel的人工智能SDK。 。 。 .
import { findTasksByDate, addTasks } from '@doist/todoist-mcp'
import { TodoistApi } from '@doist/todoist-sdk'
import { streamText } from 'ai'
// Create Todoist API client
const client = new TodoistApi(process.env.TODOIST_API_KEY)
// Helper to wrap tools with the client
function wrapTool(tool, todoistClient) {
return {
...tool,
execute(args) {
return tool.execute(args, todoistClient)
},
}
}
const result = streamText({
model: yourModel,
system: 'You are a helpful Todoist assistant',
tools: {
findTasksByDate: wrapTool(findTasksByDate, client),
addTasks: wrapTool(addTasks, client),
},
})
用作 MCP 服务器
快速启动
您可以用 npx 直接运行 MCP 服务器 :
npx @doist/todoist-mcp
设置指南
Todoist MCP服务器作为可流的HTTP服务提供,便于与各种AI客户端进行集成:
主 URL( Streamable HTTP) : https://ai.todoist.net/mcp
克劳德桌面
- 打开设置 — 连接器 — 添加自定义连接器
- 输入
https://ai.todoist.net/mcp并完成 OAuth 认证
光标
创建配置文件 :
- 全球:
~/.cursor/mcp.json - 具体项目:
.cursor/mcp.json
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://ai.todoist.net/mcp"]
}
}
}
如果提示, 则启用光标设置中的服务器 .
克劳德代码( CLI)
最快的设置是正式的托多主义插件,它为您连接了MCP服务器:
/plugin marketplace add todoist/todoist-mcp
/plugin install todoist@doist
OAuth在浏览器中运行,这是你第一次使用 Todoist 工具. 见 Anthropic 插件文件 为了更多.
如果您宁愿手动配置 MCP 服务器, 请运行 :
claude mcp add --transport http todoist https://ai.todoist.net/mcp
然后发射 claude执行 /mcp,并选择 todoist MCP服务器认证.
双子座CLI
使用 双子座CLI 0.67.0 或以后:
gemini extensions install https://github.com/todoist/todoist-mcp
开始或重新启动双子座 CLI, 然后运行 /mcp auth todoist 并签入你的托多主义账户。 Todoist主机服务器;不需要 API 密钥或本地服务器.
助理可以读取和更改您的托多主义任务和项目. 在设置 – 集成 下随时取消 Todoist 的访问 .
视觉工作室代码
- 打开命令调色板 — MCP: 添加服务器
- 选择 HTTP 传输和使用 :
{
"servers": {
"todoist": {
"type": "http",
"url": "https://ai.todoist.net/mcp"
}
}
}
其他MCP客户端
npx -y mcp-remote https://ai.todoist.net/mcp
关于建立和使用MCP服务器,包括创建自定义服务器的更详细情况,请参见 文件/mcp-server.md。 。 。 .
特征
该项目的一个关键特征是工具可以被再用,而不是专门写作用于MCP服务器. 它们可以作为工具与其它对话AI接口(如Vercel的AI SDK)相接.
该项目尚处于初期阶段。 希望很快有更多的和/或更好的工具.
尽管如此,我们的目标是提供一套小的工具,使整个工作流程成为可能,而不仅仅是原子行动,在LLMs的灵活性和效率之间取得平衡.
关于我们的设计理念、方针和发展模式,见 文件/工具设计。 。 。 .
可用工具
关于现有工具的完整清单,见 斜弧/工具 目录.
OpenAI MCP 兼容性
此服务器包括 search 财务报告和审定财务报表 fetch 工具 OpenAI MCP 规格,允许与OpenAI的MCP协议进行无缝集成. 这些工具返回了JSON编码结果,优化了OpenAI的要求,同时保持了与更广泛的MCP生态系统的相容性.
依赖关系
- 使用官方的 MCP 服务器 @ modelcontextprotocol/ 服务器
- Todoist Typescript API 客户端 @ doist/todoist-sdk (英语)
MCP 服务器设置
见 文件/mcp-server.md 用于设置 MCP 服务器的完整指令.
本地开发设置
见 文件/设置 完整设置指令和 捐款额 用于贡献者工作流程和质量检查.
MCP 应用程序
本项目包括支助 MCP 应用程序 – 交互式 UI 部件在 AI 聊天界面中实现内化 。 部件提供了丰富的工具输出的视觉表现(例如任务列表)而不是纯文本.
见 文档/mcp-apps.md 用于部件架构、建设管道和发展工作流程.
快速启动
在克隆和建立仓库后:
npm start- 建立和运行MCP检查员进行测试npm run dev- 开发模式,自动重建并重新启动npm run tool:list- 列出可供直接执行的工具npm run tool -- <tool-name> '<json-args>'- 直接运行一个没有MCP的工具
使用时 npm run tool,包括 -- 在工具参数之前, npm 转发到 scripts/run-tool.ts。 。 。 .
写入操作前的示例检查 :
npm run tool -- user-info '{}'
这证实了哪个 Todoist 记录当前 TODOIST_API_KEY 连接到.
run-tool 用途 TODOIST_API_KEY 从你的 .env 文件( 创建于 .env.example 以 npm run setup) (中文(简体) ). 在运行写入操作时使用测试账户或临时项目来避免修改真实数据.
捐款
见 捐款额 用于:
- 发展工作流程
- 直接使用工具运行
scripts/run-tool.ts - 测试和质量检查
- 提交公约
释放
这个项目使用 请放行 实现版本管理和软件包出版的自动化.
如何运作
-
使用 常规武器委员会数字 :
feat:用于新特性(小版本起伏)fix:对于错误修正( patch 版本出错)feat!:或者说fix!:用于断开更改(主要版本出错)docs:文件更改chore:维修任务ci:cI 修改
-
当犯罪被逼迫
main数字 :- 释放请自动创建/更新释放的 PR
- PR 包括版本凸起和更改日志更新
- 审查公关, 准备好后合并
-
合并发布 PR 后 :
- 自动创建新的 GitHub 发布
- 创建了新标签
- 这个
publish启动工作流程 - 软件包发布到 npm