AI导哈

TickTick任务管理协议服务器

一个基于模型上下文协议（MCP）的服务器，允许AI助手通过自然语言管理TickTick任务，包括创建、读取、更新、完成和移动任务。

  • by produckteavity
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 produckteavity/ticktick-mcp

使用说明

ticktick mcp服务器

A. 模型上下文协议 （MCP）服务器，将AI助手连接到您的 滴答清单 任务。创建、阅读、更新、完成和移动任务——所有这些都是通过自然语言完成的。

平台： 仅限macOS。令牌存储使用macOS钥匙链。计划支持Linux和Windows。

运作原理

此服务器实现 模型上下文协议，允许像克劳德这样的人工智能助手通过自然对话来管理你的TickTick任务。配置后，您可以说“创建一个任务来购买周五到期的杂货”或“向我展示所有标记为@work的任务”

先决条件

  • Node.js 18岁或以后
  • A. 滴答清单 账户
  • A. Ktyck OAuth应用程序:
    1. 首选 developer.ticktick.com/manager
    2. 创建新应用程序
    3. 设置 重定向URI 到 http://localhost:19876/callback
    4. 复制您的 客户端ID 和 客户端密钥

设置

1.授权

运行一次将服务器连接到您的TickTick帐户：

TICKTICK_CLIENT_ID=your_client_id \
TICKTICK_CLIENT_SECRET=your_client_secret \
npx ticktick-mcp-server-auth

这将打开您的浏览器以获得OAuth同意，并将令牌安全地存储在macOS Keychain中。

2.配置您的MCP客户端

添加到您的MCP客户端配置中（例如Claude Desktop、Claude Code）：

{
  "mcpServers": {
    "ticktick": {
      "command": "npx",
      "args": ["-y", "ticktick-mcp-server"],
      "env": {
        "TICKTICK_CLIENT_ID": "your_client_id"
      }
    }
  }
}

可用工具

工具 说明
ticktick_create_task 创建新任务（需要标题；内容、项目、标签、优先级、日期、重复可选）
ticktick_get_task 获取单个任务的完整详细信息
ticktick_get_tasks 列出带有可选过滤器（项目、标签、日期范围、完成状态）的任务
ticktick_update_task 修改现有任务的属性（包括重复）
ticktick_complete_task 将任务标记为已完成
ticktick_move_task 在项目之间移动任务
ticktick_get_projects 列出所有项目/列表
ticktick_create_project 创建新项目/列表

示例提示

配置后，请使用您的AI助手尝试以下操作：

  • “显示本周到期的任务”
  • “在我的工作项目中以高优先级创建一个名为“审查PR#42”的任务”
  • “将购物清单任务移至我的个人项目”
  • “TickTick中有哪些项目？”
  • “创建一个定期任务，在每月1日支付租金”

故障排除

错误 修复
Authentication failed 重新运行上面的auth命令以刷新令牌
Rate limited 等待指示的秒数，然后重试
Auth命令挂起 确保端口19876未被其他进程使用
TICKTICK_CLIENT_ID not set 确保在MCP客户端配置中设置了env var

局限性

  • 仅限macOS --使用macOS Keychain进行令牌存储
  • 移动任务 在目标项目中创建副本并完成原件；任务ID更改
  • 列出所有任务 （不带项目筛选器）按顺序获取每个项目
  • 子任务和附件 目前不支持

许可证

麻省理工学院

相关 MCP