TickTick Mcp V2

TickTick MCP v2

适用于 TickTick 的模型上下文协议（MCP）服务，可通过 v2 接口，让你直接通过 Claude 和其他 MCP 客户端与 TickTick 任务管理系统交互。

项目目的

1. 便捷认证：直接使用用户名和密码进行认证。

2. 丰富的 API 功能：v2 接口易于实现更复杂的功能。例如，其他 TickTick v1 接口甚至无法从收件箱中检索任务。

功能

• 📋 查看所有 TickTick 项目和任务
• ✏️ 通过自然语言创建新项目和任务
• 🔄 更新现有任务详情（标题、内容、日期、优先级）
• ✅ 将任务标记为已完成
• 🗑️ 删除任务和项目
• 🔐 使用用户名和密码进行认证，并在本地存储凭据

快速开始

创建一个 mcp.json 文件：

{
  "mcpServers": {
    "ticktick-mcp-v2": {
      "command": "uvx",
      "args": ["--from", "ticktick-mcp-v2", "ticktick-mcp", "run"],
      "env": {
        "TICKTICK_USERNAME": "your_username",
        "TICKTICK_PASSWORD": "your_password"
      }
    }
  }
}

开始使用

现在，你可以直接与 TickTick 任务交互了！试着这样提问：

• “显示我所有的 TickTick 项目”
• “创建一个名为‘完成文档’且优先级为高的任务”
• “我今天有哪些到期任务？”

开发环境设置

1. 安装并进行认证：

   uvx --from ticktick-mcp-v2 ticktick-mcp auth
   

2. 测试连接：

   uvx --from ticktick-mcp-v2 ticktick-mcp test
   

3. 运行服务：

   uvx --from ticktick-mcp-v2 ticktick-mcp run
   

使用示例

与其他 MCP 客户端配合使用

任何兼容 MCP 的客户端都可以使用上述配置进行连接。

可用的 MCP 工具

工具	描述	参数
认证
auth_status	检查认证状态	无
项目管理
get_projects	列出所有项目	无
get_project	获取项目详情	project_id
create_project	创建新项目	name、color（可选）、view_mode（可选）
delete_project	删除项目	project_id
get_project_tasks	获取项目中的任务	project_id、include_completed（可选）
任务管理
get_tasks	列出所有任务	include_completed（可选）
create_task	创建新任务	title、project_id（可选）、content（可选）、start_date（可选）、due_date（可选）、priority（可选）
update_task	更新任务	task_id、project_id（可选）、title（可选）、content（可选）、start_date（可选）、due_date（可选）、priority（可选）
delete_task	删除任务	project_id、task_id
complete_task	将任务标记为已完成	task_id
高级功能
search_tasks	搜索任务	query
get_tasks_by_priority	按优先级获取任务	priority（0=无、1=低、3=中、5=高）
get_tasks_due_today	获取今天到期的任务	无
get_overdue_tasks	获取逾期任务	无

示例提示词

• “显示我所有的 TickTick 项目”
• “创建一个名为‘完成文档’且优先级为高的任务”
• “我今天有哪些到期任务？”
• “将‘买杂货’任务标记为已完成”
• “将‘会议记录’任务的到期日期更新为明天”

致谢

本项目的实现离不开以下优秀开源项目：

🎯 ticktick-py

原作者：Michael Lazeroff
分支维护者：yidianyiko

为此 MCP 服务提供支持的核心 TickTick Python SDK。这个非官方 API 库全面提供了对 TickTick 功能的访问，使其能够与 TickTick 任务管理平台无缝集成。

🤝 贡献

如果你觉得这个项目有用，请考虑：

• 🐛 报告问题或提出改进建议
• 📖 参与贡献

许可证

MIT 许可证——详情请参阅 LICENSE 文件。