连接器指南阅读约 1 分钟9 个 MCP 工具7 种语言

如何将 Toggl Track 连接到 Gemini — 通过 MCP

从任何 AI 代理管理 Toggl Track(时间条目、项目、客户、标签、工作区)。9 个工具,使用 API 令牌的基本身份验证。

HC作者:HelpCode 团队更新于 1 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Toggl Track

Toggl Track

Manage Toggl Track (time entries, projects, clients, tags, workspaces) from any AI agent. 9 tools, basic-auth with API token.

个工具

9

区域

INTL

类别

工时跟踪

身份验证

Basic Auth

所需环境变量

TOGGL_API_TOKEN
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

跳过安装。2 分钟内即可运行。

在 cloud.anythingmcp.com 开始免费试用,一键添加 Toggl Track,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。

开始免费试用

摘要

从任何 AI 代理管理 Toggl Track(时间条目、项目、客户、标签、工作区)。9 个工具,使用 API 令牌的基本身份验证。

试试这样问

Toggl Track 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Toggl Track · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Toggl Track,粘贴你的凭据,生成 MCP API 密钥 — 完成。无需 Docker,无需 git clone,无需本地服务器。

Toggl Track + Gemini

从任何 AI 代理管理 Toggl Track(时间条目、项目、客户、标签、工作区)。9 个工具,使用 API 令牌的基本身份验证。

前提条件

请查看连接器中包含的完整设置说明(在你选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

TOGGL_API_TOKEN

第一步 — 获取凭据

此连接器封装了 Toggl Track API v9 (api.track.toggl.com/api/v9)。

设置:

  1. 登录 https://track.toggl.com → 左下角头像 → 个人资料设置 → 滚动到 API 令牌 → 显示/复制。
  2. 设置 TOGGL_API_TOKEN。

身份验证:HTTP Basic,使用 API 令牌作为用户名,字面字符串 api_token 作为密码: Authorization: Basic base64(TOKEN:api_token) 适配器通过 BASIC_AUTH 自动设置此项(用户名=token,密码=api_token)。请勿传递真实用户/密码 — Toggl 仅接受令牌对。

…(在应用内连接器说明中继续)

第二步 — 安装适配器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json(Windows 上为 %USERPROFILE%\.gemini\settings.json)读取 MCP 服务器。添加:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换 YOUR_MCP_API_KEY。
  2. 保存文件并重启 gemini。
  3. 在 Gemini CLI 中运行 /mcp(或在终端运行 gemini mcp list)— anythingmcp 应显示为已连接。
  4. 开始输入提示 — Gemini CLI 现在可以调用 Toggl Track 的工具。

可用工具

工具功能
toggl_track_me获取经过身份验证的用户,包括默认工作区 ID、所有工作区、默认项目/标签
toggl_track_list_workspaces列出用户所属的工作区
toggl_track_list_clients列出工作区中的客户
toggl_track_list_projects列出工作区中的项目
toggl_track_get_current_entry返回当前正在运行的时间条目(如果有),否则返回 null
toggl_track_list_time_entries列出当前用户的时间条目
toggl_track_create_time_entry创建新的时间条目
toggl_track_stop_time_entry停止正在运行的时间条目
toggl_track_delete_time_entry永久删除时间条目

常见问题

Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

这份指南对你有帮助吗?

你的 Toggl Track 智能体只差一次点击。

安装连接器,粘贴密钥,向 Gemini 提问。免费试用 7 天,无需信用卡。

相关指南