Ticktick MCP Server

🚀 點動點 (TickTick) MCP 服務器

這是一個用於與 TickTick 應用程序交互的 MCP（多功能控制處理器）服務器。它允許通過命令行或其他集成方式自動化和管理 TickTick 的任務、提醒和其他功能。

🚀 快速開始

若要使用點動點 (TickTick) MCP 服務器，需先完成安裝和配置，以下為你詳細介紹操作步驟。

📦 安裝指南

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

✨ 主要特性

管理任務和提醒

• 創建任務：通過 REST 或 RPC 接口添加新的任務或提醒。
• 更新任務：修改現有任務的狀態、優先級或其他屬性。
• 刪除任務：通過指定的任務 ID 刪除任務。
• 查詢任務：搜索特定的任務或按標籤分類。

時區和日曆集成

• 支持多種時區，確保全球用戶都能正確同步時間。
• 集成 Google Calendar 和其他第三方日曆服務。

批量操作

• 批量創建、更新或刪除多個任務。
• 導出數據到 CSV 或 JSON 格式以便進一步處理。

💻 使用示例

示例：Claude Desktop 配置

在 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. 第一次授權流程

首次運行服務器時，您需要完成授權流程：

1. MCP 服務器會打開瀏覽器並重定向到 TickTick 登錄頁面。
2. 使用您的 TickTick 賬戶登錄。
3. 授予應用程序所需的權限。
4. 生成的訪問令牌將顯示在瀏覽器中，請將其複製並設置為環境變量 TICKTICK_ACCESS_TOKEN。

TickTick 開發者控制檯

訪問 TickTick 開發者門戶

您可以通過以下鏈接訪問 TickTick 的開發者控制檯：https://developer.ticktick.com/manage。

創建應用並獲取憑據

1. 登錄後轉到“應用管理”頁面。
2. 點擊“創建新應用”。
3. 填寫應用信息並提交。
4. 在應用詳情頁中，找到 CLIENT_ID 和 CLIENT_SECRET。

常見問題解答

如何生成新的訪問令牌？

1. 在 TickTick 開發者控制檯中，轉到“憑據”頁面。
2. 點擊“生成新令牌”。
3. 按照提示完成驗證流程並獲取新的訪問令牌。

服務器無法啟動怎麼辦？

• 檢查環境變量是否正確配置。
• 確保網絡連接正常。
• 查看控制檯輸出以獲取錯誤信息。

🔧 技術細節

TickTick MCP 服務器通過與 TickTick 應用程序的 API 進行交互，實現了對任務和提醒的自動化管理。它支持多種接口調用方式，如 REST 和 RPC，方便用戶根據自己的需求進行集成。同時，服務器還支持多種時區和日曆集成，確保全球用戶都能正常使用。

📄 許可證

此 MCP 服務器根據 MIT 許可證分發。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款。有關詳細信息，請參閱項目倉庫中的 LICENSE 文件。

⚠️ 重要提示

• 確保將 .env 文件添加到 .gitignore，避免敏感信息被提交到版本控制系統。
• 定期更新訪問令牌以減少安全風險。

總結

TickTick MCP 服務器為您提供了一種強大的方式來自動化和管理 TickTick 應用程序的任務和提醒功能。通過簡單的命令行接口或 RPC 調用，您可以輕鬆實現任務的批量操作、日曆集成以及其他高級功能。