JinDaGe - ticktick-mcp-server MCP Details

article

README

🚀 点动点 (TickTick) MCP 服务器

这是一个用于与 TickTick 应用程序交互的 MCP（多功能控制处理器）服务器。它允许通过命令行或其他集成方式自动化和管理 TickTick 的任务、提醒和其他功能。

🚀 快速开始

本服务器可让你通过命令行或其他集成方式，对 TickTick 的任务、提醒等功能进行自动化管理。下面为你介绍使用该服务器的具体步骤。

✨ 主要特性

TickTick API 功能

管理任务和提醒：可通过 REST 或 RPC 接口创建、更新、删除和查询任务。
时区和日历集成：支持多种时区，还能与 Google Calendar 等第三方日历服务集成。
批量操作：支持批量创建、更新或删除多个任务，也能将数据导出为 CSV 或 JSON 格式。

📦 安装指南

1. 安装依赖

确保已安装 Node.js 和 npm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash  
source ~/.bashrc  
nvm install --lts  
npm install -g @alexarevalo.ai/mcp-server-ticktick

2. 运行 MCP 服务器

运行以下命令启动服务器：

npx @alexarevalo.ai/mcp-server-ticktick start

💻 使用示例

基础用法

在 Claude Desktop 中配置 TickTick MCP 服务器：

{
  "mcpServers": [
    {
      "name": "ticktick-mcp",
      "type": "custom",
      "host": "localhost",
      "port": "3000",
      "protocol": "http"
    }
  ]
}

📚 详细文档

配置 TickTick MCP 服务器

1. 环境变量配置

创建一个 .env 文件并添加以下内容：

TICKTICK_CLIENT_ID=your_client_id  
TICKTICK_CLIENT_SECRET=your_client_secret  
TICKTICK_ACCESS_TOKEN=your_access_token

2. 第一次授权流程

首次运行服务器时，您需要完成授权流程：

MCP 服务器会打开浏览器并重定向到 TickTick 登录页面。
使用您的 TickTick 账户登录。
授予应用程序所需的权限。
生成的访问令牌将显示在浏览器中，请将其复制并设置为环境变量 TICKTICK_ACCESS_TOKEN。

TickTick 开发者控制台

访问 TickTick 开发者门户

您可以通过以下链接访问 TickTick 的开发者控制台：https://developer.ticktick.com/manage。

创建应用并获取凭据

登录后转到“应用管理”页面。
点击“创建新应用”。
填写应用信息并提交。
在应用详情页中，找到 CLIENT_ID 和 CLIENT_SECRET。

常见问题解答

如何生成新的访问令牌？

在 TickTick 开发者控制台中，转到“凭据”页面。
点击“生成新令牌”。
按照提示完成验证流程并获取新的访问令牌。

服务器无法启动怎么办？

检查环境变量是否正确配置。
确保网络连接正常。
查看控制台输出以获取错误信息。

🔧 技术细节

TickTick MCP 服务器借助命令行或其他集成方式，实现对 TickTick 应用任务、提醒等功能的自动化管理。它支持多种时区，能与第三方日历服务集成，还可进行批量任务操作和数据导出。通过 REST 或 RPC 接口，可方便地对任务进行创建、更新、删除和查询等操作。

📄 许可证

此 MCP 服务器根据 MIT 许可证分发。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款。有关详细信息，请参阅项目仓库中的 LICENSE 文件。

⚠️ 重要提示

确保将 .env 文件添加到 .gitignore，避免敏感信息被提交到版本控制系统。

定期更新访问令牌以减少安全风险。

ticktick-mcp-server