AI导哈

任务管理服务器

TickTick MCP服务器是一个用于通过AI助手管理TickTick任务的全面解决方案，支持任务和项目管理、智能调度及安全认证。

  • by MostafaSuliman
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 MostafaSuliman/TickTick-MCP

使用说明

TickTick MCP服务器🎯

TickTick.com |使用AI管理您的任务

一个全面的MCP（模型上下文协议）服务器，用于直接从Claude或任何兼容MCP的AI助手管理您的TickTick任务。

特性✨

  • 任务管理：创建、更新、完成和删除任务
  • 项目管理：创建和管理项目/列表
  • 智能调度：根据任务优先级和截止日期生成每日时间表
  • OAuth2身份验证：使用TickTick的官方API进行安全身份验证
  • 丰富的格式：美观的标记输出，便于阅读

先决条件

  • Python 3.10或更高版本
  • TickTick账户
  • TickTick开发者应用程序（我们将在下面创建）

安装

步骤1：克隆/复制服务器

# Create directory
mkdir -p ~/ticktick-mcp
cd ~/ticktick-mcp

# Copy the files (ticktick_mcp.py and pyproject.toml)

步骤2：安装依赖项

# Using pip
pip install mcp httpx pydantic

# Or using the project
cd ~/ticktick-mcp
pip install -e .

步骤3：注册TickTick开发者应用程序

  1. 首选 TickTick开发者门户
  2. 使用您的TickTick帐户登录
  3. 点击 “+应用程序名称” 创建新应用程序
  4. 输入名称（例如“Claude MCP Integration”）
  5. 重要：将OAuth重定向URL设置为： http://127.0.0.1:8080/callback
  6. 点击保存
  7. 记下你的 客户端ID 和 客户端密钥

配置

适用于克劳德桌面

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ticktick": {
      "command": "python",
      "args": ["/path/to/ticktick-mcp/ticktick_mcp.py"],
      "env": {}
    }
  }
}

使用紫外线（推荐）:

{
  "mcpServers": {
    "ticktick": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ticktick-mcp", "python", "ticktick_mcp.py"]
    }
  }
}

对于其他MCP客户端

直接运行服务器：

python ticktick_mcp.py

首次设置（OAuth身份验证）

连接MCP服务器后，按顺序使用这些工具：

1.配置凭据

告诉克劳德：

“使用我的凭据配置TickTick：客户端ID为 YOUR_CLIENT_ID 客户端密码为 YOUR_CLIENT_SECRET"

这将：

  • 安全地保存您的凭据
  • 生成一个授权URL供您访问

2.授权应用程序

  1. Claude将提供一个授权URL
  2. 在浏览器中打开URL
  3. 登录TickTick并单击“允许”
  4. 您将被重定向到以下URL： http://127.0.0.1:8080/callback?code=ABCD1234&state=mcp_auth
  5. 复制 代码 参数(ABCD1234 在这个例子中）

3.完成授权

告诉克劳德：

“使用代码ABCD1234完成TickTick授权”

您现在已通过身份验证！令牌将缓存约6个月。

可用工具

认证

工具 说明
ticktick_configure 配置API凭据
ticktick_authorize 完整的OAuth流程
ticktick_check_auth 检查身份验证状态

任务

工具 说明
ticktick_list_tasks 列出所有未完成的任务
ticktick_get_task 获取特定任务的详细信息
ticktick_create_task 创建新任务
ticktick_update_task 更新现有任务
ticktick_complete_task 将任务标记为已完成
ticktick_delete_task 删除任务

项目

工具 说明
ticktick_list_projects 列出所有项目/列表
ticktick_create_project 创建新项目
ticktick_delete_project 删除项目

调度

工具 说明
ticktick_schedule_time 制定每日日程表
ticktick_get_today 快速查看今天的任务

使用示例

列出您的任务

“显示我的所有TickTick任务”

任务

“创建TickTick任务：审查明天到期的第四季度报告，具有高优先级”

安排你的一天

“帮助我根据TickTick任务计划我的一天”

创建项目

“创建一个名为‘副业创意’的新TickTick项目”

完成任务

“将项目xyz中的任务ID abc123标记为已完成”

任务优先级

优先级 价值 表情符号
无 0 ⚪
低 1 🟢
中等 3 🟡
高 5 🔴

文件位置

服务器将配置和令牌存储在您的主目录中：

  • 配置: ~/.ticktick-mcp-config.json
  • OAuth令牌: ~/.ticktick-mcp-token.json

要重置身份验证，请删除这些文件。

故障排除

“未通过身份验证”错误

跑 ticktick_check_auth 验证您的身份验证状态，然后在需要时重新运行OAuth流。

“令牌过期”错误

删除 ~/.ticktick-mcp-token.json 并重新进行身份验证。

“超出速率限制”错误

请稍等片刻，然后再提出更多请求。TickTick有API利率限制。

“找不到资源”错误

仔细检查任务ID和项目ID。使用 ticktick_list_tasks 查看有效ID。

api参考

此服务器使用TickTick的官方开放API：

贡献

请随意扩展此服务器！一些想法：

  • 添加对习惯的支持
  • 添加番茄钟集成
  • 添加日历视图
  • 添加定期任务支持
  • 添加标签管理工具

许可证

MIT许可证-随意使用和修改！

建于❤️ 适用于使用Claude和TickTick的生产力爱好者。

相关 MCP