Focus To-Do MCP Server

繁體中文 | English

為 Focus To-Do（專注清單） 打造的 MCP（Model Context Protocol）伺服器，讓 AI 助理（Claude Code、Claude Desktop 等）可以用自然語言操作你的番茄鐘任務。

起心動念： Focus To-Do 一直沒有開放公開 API，所以我自己逆向工程做了這個 MCP，讓 AI 助理也能串接它。本專案與 Focus To-Do 官方無關，亦未獲其授權。

---

⚡ 快速設定

步驟一：Clone 並安裝

git clone https://github.com/gyozalab/focustodo-mcp.git
cd focustodo-mcp
npm install
npm run build

步驟二：加入 MCP 設定檔

將以下內容加入 Claude Code 的 .mcp.json 或 Claude Desktop 的設定檔：

{
  "mcpServers": {
    "focustodo": {
      "command": "node",
      "args": ["/your/path/to/focustodo-mcp/dist/index.js"],
      "env": {
        "FOCUSTODO_ACCOUNT": "your-email@example.com",
        "FOCUSTODO_PASSWORD": "your-password"
      }
    }
  }
}

將 /your/path/to/focustodo-mcp 換成你實際的路徑，帳密填入你的 Focus To-Do 登入資訊。

完成後重啟 Claude，就可以開始用了。

---

使用範例

設定完成後，直接這樣問 AI：

• 「列出我的 Blog 清單任務」
• 「幫我加一個任務到書寫 Output：寫 AI 工具評測文章，3 顆番茄」
• 「這週我花最多時間在哪個清單？」
• 「今天我專注了多久？」

---

功能列表

工具	說明
focustodo_list_projects	列出所有專案與標籤清單
focustodo_list_tasks	列出任務（可依專案、標籤、優先度、狀態篩選）
focustodo_search_tasks	依關鍵字搜尋任務
focustodo_get_task_detail	查看任務詳情（含子任務與番茄鐘紀錄）
focustodo_create_task	建立新任務
focustodo_update_task	更新任務屬性
focustodo_complete_task	將任務標記為完成
focustodo_delete_task	刪除任務
focustodo_create_subtask	新增子任務
focustodo_get_today_focus	取得今日專注時間與番茄鐘次數
focustodo_get_stats	查詢專注統計（可依時段與專案篩選）

---

技術說明

• API Base：https://app.hk1.focustodo.net/
• 驗證方式：Email + 密碼登入 → Cookie-based Session
• 同步機制：透過 POST /v64/sync 進行雙向完整同步
• 資料模型：
  • type=1000 → 一般專案／清單
  • type=3000 → 標籤虛擬清單（任務透過 tags 欄位以專案 ID 參照）
• 自動重新登入：Session 過期時自動重新驗證

---

授權

MIT