AI导哈

任务管理MCP服务器

TickTick MCP服务器是一个基于Cloudflare Workers的远程Model Context Protocol服务器，提供22种工具用于管理TickTick项目和任务。

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

使用说明

TickTick MCP服务器

遥控器 模型上下文协议（MCP） 服务器 TickTick 任务管理，托管在Cloudflare Workers上。

提供22个MCP工具，用于通过任何MCP客户端（Claude Desktop等）管理TickTick项目和任务。

特性

  • 项目管理：创建、读取、删除项目
  • 任务CRUD：创建、阅读、更新、完成、删除任务
  • 搜索和筛选：搜索任务，按优先级、日期范围筛选
  • GTD支持：已处理的任务、下一个任务、批创建、子任务
  • 认证：用于MCP客户端的GitHub OAuth，用于后端的TickTick API令牌

设置

1.先决条件

2.克隆和安装

git clone https://github.com/k-wakamatsu-tms/ticktick-mcp-server.git
cd ticktick-mcp-server
npm install

3.配置机密

wrangler secret put GITHUB_CLIENT_ID
wrangler secret put GITHUB_CLIENT_SECRET
wrangler secret put GITHUB_ALLOWED_LOGINS
wrangler secret put COOKIE_ENCRYPTION_KEY
wrangler secret put TICKTICK_ACCESS_TOKEN
wrangler secret put TICKTICK_CLIENT_ID
wrangler secret put TICKTICK_CLIENT_SECRET

对于本地开发，请复制 .dev.vars.example 到 .dev.vars 并填写数值。

4.创建KV命名空间

wrangler kv namespace create OAUTH_KV

更新 id 在 wrangler.jsonc 使用返回的命名空间ID。

5.部署

npm run deploy

6.从克劳德桌面连接

添加到您的Claude Desktop MCP配置中：

{
  "mcpServers": {
    "ticktick": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://ticktick-mcp-server.<your-subdomain>.workers.dev/mcp"
      ]
    }
  }
}

本地开发

cp .dev.vars.example .dev.vars
# Edit .dev.vars with your credentials
npm run dev

可用工具（22）

项目（4）

工具 说明
get_projects 获取所有项目
get_project 获取特定项目
create_project 创建新项目
delete_project 删除项目

任务CRUD（6）

工具 说明
get_project_tasks 获取项目中的所有任务
get_task 获取特定任务
create_task 创建新任务
update_task 更新现有任务
complete_task 将任务标记为已完成
delete_task 删除任务

搜索和筛选（8）

工具 说明
get_all_tasks 从所有项目中获取所有任务
search_tasks 按关键字搜索任务
get_tasks_by_priority 按优先级筛选
get_tasks_due_today 今天到期的任务
get_tasks_due_tomorrow 明天到期的任务
get_tasks_due_in_days N天后到期的任务
get_tasks_due_this_week 本周到期的任务
get_overdue_tasks 逾期任务

GTD和批次（4）

工具 说明
get_engaged_tasks 高优先级/今天到期/逾期
get_next_tasks 中等优先级/明天到期
batch_create_tasks 一次创建多个任务
create_subtask 在父级下创建子任务

环境变量

变量 目的
GITHUB_CLIENT_ID GitHub OAuth应用程序客户端ID
GITHUB_CLIENT_SECRET GitHub OAuth应用程序客户端密钥
GITHUB_ALLOWED_LOGINS 允许使用逗号分隔的GitHub用户名（未设置则拒绝所有访问）
COOKIE_ENCRYPTION_KEY cookie签名的随机密钥
TICKTICK_ACCESS_TOKEN TickTick API访问令牌
TICKTICK_CLIENT_ID TickTick应用程序客户端ID（用于将来刷新）
TICKTICK_CLIENT_SECRET TickTick应用程序客户端机密（用于将来刷新）

许可证

麻省理工学院

相关 MCP