mcp-server-toggl

An MCP server for Toggl Track that provides team-wide time tracking, reporting, and workspace management through the Model Context Protocol.

Built on Toggl's v9 API and Reports API v3, this server lets AI assistants query time entries, generate summary reports, and browse workspace data across your entire team — not just the authenticated user.

Setup

1. Get a Toggl API Token

1. Log in to Toggl Track
2. Go to your Profile Settings
3. Scroll to the bottom and copy your API Token

2. Configure Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "toggl": {
      "command": "npx",
      "args": ["-y", "mcp-server-toggl"],
      "env": {
        "TOGGL_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

3. Build from Source (optional)

git clone https://github.com/longrackslabs/mcp-server-toggl.git
cd mcp-server-toggl
npm install
npm run build

Then point your MCP client at the built server:

{
  "mcpServers": {
    "toggl": {
      "command": "node",
      "args": ["/path/to/mcp-server-toggl/dist/index.js"],
      "env": {
        "TOGGL_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Tools

Workspace & Organization

| Tool | Description | |------|-------------| | toggl_list_workspaces | List all accessible workspaces with IDs and premium status | | toggl_list_projects | List projects in a workspace (auto-paginated, filterable by active status and client) | | toggl_get_project | Get details for a single project | | toggl_list_clients | List all clients in a workspace | | toggl_list_users | List team members with IDs, names, and emails (requires admin access) | | toggl_list_tasks | List tasks within a project (sub-categories like Vacation, Sick, Holiday) |

Reporting

| Tool | Description | |------|-------------| | toggl_search_time_entries | Search time entries across all team members. Supports filtering by project, client, user, task, and description. Auto-paginates and enriches results with names. | | toggl_get_summary_report | Get aggregated time totals grouped by users, projects, or clients. Supports sub-grouping for breakdowns like "each user's time by project." |

Example Prompts

• "How many hours did each team member log last week?"
• "Show me all time entries for the Marketing project this month"
• "What's the PTO breakdown by person for Q1?"
• "List all active projects in workspace 12345"
• "How much time was logged against Client X in January?"

Requirements

• Node.js 18+
• A Toggl Track account with an API token
• Admin access for toggl_list_users (other tools work with any role)

License

MIT