发送 MCP 和 AI 工具
MCP服务器和可导入的用于todoist Comms API的AI工具. 使用 工具通过 MCP 服务器,或直接导入以插入通讯 您自己的 AI 对话界面.
使用工具
1. 安装
npm install @doist/comms-mcp
2. 将它们插入大赦国际
示例 Vercel的人工智能SDK数字 :
import { fetchInbox, reply, markDone } from '@doist/comms-mcp'
import { streamText } from 'ai'
const result = streamText({
model: yourModel,
system: 'You are a helpful Comms assistant',
tools: {
fetchInbox,
reply,
markDone,
},
})
用作 MCP 服务器
快开始
npx @doist/comms-mcp
设置
克劳德桌面
添加为 claude_desktop_config.json数字 :
{
"mcpServers": {
"comms": {
"command": "npx",
"args": ["-y", "@doist/comms-mcp"],
"env": {
"COMMS_API_KEY": "your-comms-api-key-here"
}
}
}
}
光标
~/.cursor/mcp.json (全球)或 .cursor/mcp.json (按项目):
{
"mcpServers": {
"comms": {
"command": "npx",
"args": ["-y", "@doist/comms-mcp"],
"env": {
"COMMS_API_KEY": "your-comms-api-key-here"
}
}
}
}
克劳德代码( CLI)
claude mcp add comms npx @doist/comms-mcp
export COMMS_API_KEY=your-comms-api-key-here
视觉工作室代码
- 命令调色板 — MCP: 添加服务器
- 配置 :
{
"servers": {
"comms": {
"command": "npx",
"args": ["-y", "@doist/comms-mcp"],
"env": {
"COMMS_API_KEY": "your-comms-api-key-here"
}
}
}
}
针对非生产部署
默认情况下,服务器会向 https://comms.todoist.com。指向
装入或自定义部署,也设定 COMMS_BASE_URL数字 :
"env": {
"COMMS_API_KEY": "your-comms-api-key-here",
"COMMS_BASE_URL": "https://comms.staging.todoist.com"
}
获取通讯 API 密钥
通讯接受您的 Todoist API 令牌 。 在 Todoist 中, 打开 设置 −
集成 – 开发者 并复制 API 令牌,然后导出为
COMMS_API_KEY (或粘入上方的MCP客户端配置). 它已经
完全进入你的账户, 所以保密.
特征
这些工具有意采用工作流程形状,而不是1:1包装 环绕 API 端点,所以 LLM 可以用一个 少量电话.
可用工具
- 用户信息 - 关于当前用户的信息,包括其状况
- 更新用户信息 ——更改用户名称,时区,语言或状态. 该状态与托多主义者(消息、emoji、结束、暂停通知或Karma)共享。 在 OAuth 连接上需要
user:write范围 - 获取信箱 - 收件箱里的线索和谈话
- 装入线索 - 用其评论装入一条线索
- 装入集合 - 装入其信件的对话
- 搜索内容 搜索线索、评论和信件的工作空间
- 获取对象 ——提及当前用户的线索、评论和信件
- 创建频道 编号 : 更新频道 ——通过MCP创建或更新工作空间频道
- 创建图 ——启动新频道线程. 接受可选选项
displayInInbox布尔( 默认)false) (中文(简体) ). 何时true,线程在创建后未存档,所以它出现在作者的收件箱中. 另见 COMMS CREATE THREAD DISPLAY IN-INBOX (英语)。 。 。 . - 更新对象 编号 : 删除对象 编辑或删除线索、注释或信件
- 回复 对线索或谈话的答复
- 反应 ——对线索、评论、谈话或消息添加反应
- 标记 ——将线程或对话标为已读和/或存档
- 读取标记 将线程和/或对话标为未存档的已读( 特定 ID, 或工作空间中未读的所有内容)
- 构建链接 ——将 URL 构建为 Comps 资源
- 列表 编号 : 获取组 编号 : 获取用户 编号 : 获取工作空间 ——发现帮手
详情见 斜弧/工具。 。 。 .
环境变量
| 变量 | 默认 | 说明 |
|---|---|---|
COMMS_API_KEY | (必须) | 您的通讯 API 密钥 . |
COMMS_CREATE_THREAD_DISPLAY_IN_INBOX | false | 设定为 true 将每个新创建的线程解锁, 这样它就出现在作者的收件箱中, 而无需通过 displayInInbox: true 每个电话. 只在本地运行 MCP 时生效 . 远程/托管的 MCP 中没有此可变集, 并将使用每个调用 displayInInbox 参数. |
依赖关系
- MCP 服务器使用正式 @ modelcontextprotocol/ 服务器
- 通讯机类型SDK @ doist/comms-sdk (英语)
地方发展
先决条件
- 节点.js 20.18.1+
- 无
- 通讯 API 令牌
设置
git clone https://github.com/todoist/comms-mcp.git
cd comms-mcp
npm install
cp .env.example .env # then add your COMMS_API_KEY
npm run build
图标
npm start- 建立并管理MCP检查员npm run dev– 自动重新启动的监视模式npm test- 维特npm run type-check— 类型脚本npm run format:check编号 :npm run format:fix——克克林特+克克夫克特
直接运行单个工具
npx tsx scripts/run-tool.ts user-info '{}'
npx tsx scripts/run-tool.ts --list
捐款
- 考试合格(
npm test(中文(简体) ) - 类型
npm run type-check(中文(简体) ) - Lint 格式通过( F)
npm run format:check(中文(简体) )
使用 常规武器委员会 —— 说 feat:, (中文(简体) ), fix:, (中文(简体) ), docs:, (中文(简体) ), test:, (中文(简体) ), chore:。 。 。 .
许可证
麻省理工学院