mcpField
T
tasklist-port

tasklist-port

本地服务
github.com/CloudCorpRecords生产力02 周前更新
代码仓库

关于 tasklist-port

tasklist-port 是通过 Todoist REST API v1 管理任务和核心项目信息的 MCP 服务与 CLI，涵盖任务、项目、标签和分区的主要操作。

主要功能

  1. 01创建、更新、完成、重开和删除任务
  2. 02列出并获取任务与项目
  3. 03创建项目及列出标签或分区
  4. 04CLI 与 stdio MCP 服务

适用场景

  1. 01通过 MCP 客户端管理 Todoist 任务
  2. 02查看项目、标签和分区
  3. 03从命令行执行 Todoist 操作

MCP 相关

它通过 stdio MCP 服务将 Todoist 的任务、项目、标签和分区操作提供为 MCP 工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-tasklist-port": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/tasklist-port"
      ]
    }
  }
}
启动命令npx -y @reneturcios/tasklist-port

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/tasklist-port0.1.0
ocighcr.io/cloudcorprecords/tasklist-port:0.1.0

工具

12

收录的工具列表 · 更新于 1 周前

参数类型必填说明
labelstring否用于筛选任务的可选标签名称。
project_idstring否要列出其任务的项目的可选标识符。
filter_querystring否可选的 Todoist 筛选查询，作为 filter 参数发送，用于筛选任务。

详细介绍

tasklist-port

将 Todoist 任务作为 MCP 工具，通过 Todoist REST API v1 进行交互。 tasklist-port 是对 Todoist MCP 服务核心功能的全新实现，采用新名称：代码全新编写，不复制品牌内容。

工具（核心子集，共 12 个）

list_tasks、get_task、create_task、update_task、close_task、 reopen_task、delete_task、list_projects、get_project、 create_project、list_labels、list_sections。

此子集不包含：评论、共享标签、协作者/共享功能、 提醒、活动日志、已完成事项历史记录、项目协作者管理、 用户/效率统计、Sync API 增量同步、备份、模板导入/导出、快速添加解析端点。

设置

在 Todoist 中创建 API 令牌（Settings → Integrations → Developer） 并设置该令牌：

export TODOIST_API_TOKEN=0123456789abcdef...

也可以通过 TODOIST_API_BASE_URL 覆盖 API 基础 URL （默认值为 https://api.todoist.com/api/v1）。如果没有设置令牌，每次 工具调用都会失败，并指出缺少的变量。注意： 根据版本不同，Todoist 列表端点返回的可能是裸数组，也可能是 {results:[...]} 封装对象；tasklist-port 会原样返回解析后的负载。

CLI

npx @reneturcios/tasklist-port list_tasks '{"project_id":"p1"}'
npx @reneturcios/tasklist-port mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "tasklist-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/tasklist-port", "mcp"],
      "env": { "TODOIST_API_TOKEN": "0123456789abcdef..." }
    }
  }
}

Docker

docker run -i -e TODOIST_API_TOKEN ghcr.io/cloudcorprecords/tasklist-port

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。