mcp-toggl

概述

MCP Toggl 为 Toggl Track 时间跟踪与兼容 MCP 的客户端之间提供全面接口。它提供结构化数据检索功能，包含条目信息丰富化处理（项目、工作空间、客户和标签）。该服务器实现了智能缓存以减少 API 调用，并支持来自 Toggl Track Desktop 的时间线分析，使用户能够分析其实际跟踪时间与应用使用模式之间的关系。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• toggl_daily_report

  Hours by project and workspace for a date

  试试:What am I tracking today?试试:Show me yesterday's hours as a chart
• toggl_weekly_report

  7-day breakdown with daily totals and project rollups

  试试:Give me a recap of my week试试:Compare this week to last week by project
• toggl_get_time_entries

  Raw hydrated entries by period, date range, workspace, or project

  试试:What am I currently tracking?试试:How much time did I spend on the website project this month?
• toggl_get_timeline

  Toggl Track Desktop app usage summary with optional raw events

  试试:Did I actually work on what I said I worked on for that PR review entry?试试:What apps did I use most today?
• toggl_get_current_entry

  Returns the running timer, elapsed seconds, and hydrated project/workspace context

  试试:What am I currently tracking?试试:How long has my current timer been running?
• toggl_start_timer

  Starts a timer with description, optional project/task, and tags

  试试:Start a timer for "PR review" on the Platform project试试:Begin tracking client meeting time
• toggl_stop_timer

  Stops the currently running timer

  试试:Stop my current timer试试:End the running task
• toggl_check_auth

  Verifies token access and lists available workspaces without exposing the token

  试试:Check if my Toggl connection is working试试:What workspaces do I have access to?
• toggl_list_workspaces

  Lists all accessible workspaces

  试试:List my Toggl workspaces试试:What workspaces do I have?
• toggl_list_projects

  Lists projects for a workspace using cache-backed reads after first fetch

  试试:Show me my projects试试:What projects are available in my main workspace?
• toggl_warm_cache

  Pre-fetches workspace, project, client, and tag data before a heavy reporting session

  试试:Warm up the Toggl cache试试:Prepare data for my weekly report
• toggl_project_summary

  Total hours per project for a period or date range

  试试:Which project took the most time this month?试试:Show me my project totals for last week

可对比工具

安装

{
  "mcpServers": {
    "mcp-toggl": {
      "command": "npx",
      "args": ["-y", "@verygoodplugins/mcp-toggl@latest"],
      "env": {
        "TOGGL_API_KEY": "your_api_key_here",
        "TOGGL_DEFAULT_WORKSPACE_ID": "123456"
      }
    }
  }
}

npm install -g @verygoodplugins/mcp-toggl
mcp-toggl --help

FAQ

这个 MCP 服务器与直接使用 Toggl 有何不同？

此服务器将原始时间条目与项目、客户和工作空间数据丰富化处理在单个 API 调用中，实现智能缓存以减少 API 请求，提供实际桌面活动的时间线分析，并优化为适合 AI 消耗和报告的格式提供结构化数据。

时间线隐私功能如何工作？

时间线功能支持三种模式：仅摘要模式（无原始事件）、事件标题遮蔽模式（保留持续时间但移除敏感信息）和完整事件模式。用户可以通过设置 include_events: false 或 redact_titles: true 来控制隐私。

mcp-toggl 对比