关键词

Toggl时间追踪LLM工具生产力任务管理

项目简介

'toggl-mcp' 是一个将Toggl时间追踪服务与大语言模型 (LLM) 客户端集成的 MCP 服务器。它使得用户可以通过自然语言指令，在大模型界面中直接管理Toggl上的计时器、项目和时间条目，无需切换应用。

主要功能点

  • 启动/停止计时器: 轻松开始新任务或停止当前运行的计时器。
  • 查看当前计时器: 了解当前正在追踪的任务及其已运行时间。
  • 查询今日时间条目: 获取当天所有时间记录及其总时长。
  • 列出所有项目: 查看Toggl工作区中的所有项目列表。
  • 删除时间条目: 根据ID删除指定的时间记录。

安装步骤

  1. 获取Toggl API Key:
    • 访问Toggl Track个人资料页面：'https://track.toggl.com/profile'
    • 向下滚动到“API Token”部分。
    • 点击“Click to reveal”以显示并复制您的API密钥。
  2. 安装'toggl-mcp': 该服务器通常作为LLM客户端的一个进程启动。您无需手动运行它，LLM客户端会在需要时自动调用。为了确保'toggl-mcp'命令全局可用，建议进行安装： 
    npm install -g @louis030195/toggl-mcp

服务器配置

MCP服务器的配置需要在您的MCP客户端（例如Claude Desktop或Claude Code）中完成。您需要提供'toggl-mcp'服务器的启动命令和您的Toggl API密钥。

  • 对于 Claude Desktop，修改配置文件 '~/Library/Application Support/Claude/claude_desktop_config.json'，添加如下配置：

    {
  "mcpServers": {
    "toggl": {
      "command": "npx",
      "args": ["-y", "@louis030195/toggl-mcp"],
      "env": {
        "TOGGL_API_KEY": "your-toggl-api-key"
      }
    }
  }
}

    在上面的配置中：

    • '"toggl"' 是您的MCP客户端中识别此服务器的名称。
    • '"command": "npx"' 指定了启动服务器的命令。
    • '"args": ["-y", "@louis030195/toggl-mcp"]' 是传递给'npx'命令的参数，用于执行'toggl-mcp'。
    • '"env": {"TOGGL_API_KEY": "your-toggl-api-key"}' 用于设置您的Toggl API密钥，请将 'your-toggl-api-key' 替换为实际的API密钥。

  • 对于 Claude Code，可以使用命令行工具进行添加：

    claude mcp add -s user toggl npx -e TOGGL_API_KEY=your-toggl-api-key -- -y @louis030195/toggl-mcp

    请将 'your-toggl-api-key' 替换为实际的API密钥。

基本使用方法

配置完成后，您可以在LLM客户端中直接使用自然语言指令来控制Toggl：

  • “开始追踪关于MCP服务器项目的工作。”
  • “停止当前的计时器。”
  • “我目前在追踪什么？”
  • “显示我今天的时间条目。”
  • “列出我所有的项目。”
  • “删除 ID 为 123456 的时间条目。”

信息

分类

生产力应用

访问项目