Lazy Toggl MCP Server

这是一个提供与Toggl时间跟踪工具交互功能的Model Context Protocol (MCP)服务器。

功能

• 开始/停止时间跟踪
• 获取当前条目
• 列出工作区

API

工具

• start_tracking

  • 开始跟踪新任务的时间
  • 输入参数：
    • title (字符串)：要跟踪的任务标题/描述
    • workspace_id (整数)：工作区ID（可选，未提供时使用默认值）
    • project_id (整数)：项目ID（可选）
    • tags (字符串数组)：标签列表（可选）

• stop_tracking

  • 停止当前正在运行的时间条目
  • 不需要输入参数
  • 返回已停止时间条目的确认信息

• list_workspaces

  • 列出所有可用的工作区
  • 不需要输入参数
  • 返回包含工作区ID和名称的工作区列表

• show_current_time_entry

  • 显示当前正在运行的时间条目（如果有）
  • 不需要输入参数
  • 返回：
    • 如果正在跟踪：任务描述、条目ID、工作区、开始时间、运行时长、标签以及项目（如果有的话）
    • 如果没有在跟踪：一条消息，表明当前没有正在运行的时间条目

与Toggl Track API的集成

此服务器使用Toggl Track API v9。以下端点被利用：

• GET /me - 获取用户信息
• GET /workspaces - 列出工作区
• GET /me/time_entries/current - 获取当前正在运行的时间条目
• POST /workspaces/{workspace_id}/time_entries - 开始时间跟踪
• PATCH /workspaces/{workspace_id}/time_entries/{time_entry_id}/stop - 停止时间跟踪

安装

1. 克隆或创建此项目
2. 使用uv安装依赖项：

   cd lazy-toggl-mcp
   uv sync
   

配置

获取您的Toggl API令牌

1. 访问Toggl Track
2. 登录到您的账户
3. 点击右上角的个人资料图片/头像
4. 转到“个人资料”或“设置”
5. 查找您的“API令牌” - 复制这个长字符串

配置MCP服务器

向您的MCP设置文件添加以下配置：

{
  "mcpServers": {
    "lazy-toggl-mcp": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "transportType": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/lazy-toggl-mcp",
        "python",
        "server.py"
      ],
      "env": {
        "TOGGL_API_TOKEN": "your-actual-api-token-here"
      }
    }
  }
}

重要提示：请将/path/to/lazy-toggl-mcp替换为此项目的实际路径，并将your-actual-api-token-here替换为您真实的Toggl API令牌。

项目结构

lazy-toggl-mcp/
├── src/
│   └── toggl_server/
│       ├── __init__.py      # 包初始化
│       ├── main.py          # MCP服务器实现（新结构）
│       ├── models.py        # 数据模型和类型定义
│       ├── toggl_api.py     # Toggl API客户端
│       └── utils.py         # 实用函数
├── main.py                  # 测试用CLI接口
├── server.py                # 主MCP服务器入口点
├── pyproject.toml           # 项目配置和依赖项
├── README.md                # 此文件
├── uv.lock                  # 依赖项锁定文件
├── .gitignore               # Git忽略模式
└── .python-version          # Python版本规范

许可证

MIT许可证 - 感觉自由地修改并按需使用。