Louis030195/toggl MCP

1# @louis030195/toggl-mcp
2 
3Dead simple MCP (Model Context Protocol) server for Toggl time tracking. Control your Toggl timer directly from Claude, ChatGPT, or any LLM that supports MCP.
4 
5[![Support Development](https://img.shields.io/badge/Support-Development-yellow?style=for-the-badge)](https://buy.stripe.com/14A14n0eZ1wyfix9a8gA802)
6 
7## Features
8 
9- ⏱️ Start/stop timers
10- 📊 View current timer
11- 📈 Get today's time entries
12- 🗂️ List projects
13- 🗑️ Delete time entries
14 
15## Installation
16 
17### Claude Desktop
18 
19Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):
20 
21```json
22{
23  "mcpServers": {
24    "toggl": {
25      "command": "npx",
26      "args": ["-y", "@louis030195/toggl-mcp"],
27      "env": {
28        "TOGGL_API_KEY": "your-toggl-api-key"
29      }
30    }
31  }
32}
33```
34 
35### Claude Code
36 
37```bash
38# Install globally in user scope with API key
39claude mcp add -s user toggl npx -e TOGGL_API_KEY=your-toggl-api-key -- -y @louis030195/toggl-mcp
40```
41 
42## Get Your Toggl API Key
43 
441. Go to [Toggl Track Profile](https://track.toggl.com/profile)
452. Scroll down to "API Token"
463. Click "Click to reveal" and copy your token
47 
48## Usage
49 
50Once configured, you can use natural language to control Toggl:
51 
52- "Start tracking work on the MCP server project"
53- "Stop the current timer"
54- "What am I currently tracking?"
55- "Show me today's time entries"
56- "List all my projects"
57 
58## Tools
59 
60### `toggl_start`
61Start a new timer with a description and optional project.
62 
63### `toggl_stop`
64Stop the currently running timer.
65 
66### `toggl_current`
67Get information about the currently running timer.
68 
69### `toggl_today`
70Get all time entries for today with total duration.
71 
72### `toggl_projects`
73List all projects in your workspace.
74 
75### `toggl_delete`
76Delete a time entry by its ID.
77 
78### `toggl_weekly`
79Get weekly time tracking summary with total hours and breakdowns.
80- Parameters: `week_offset` (optional, number)
81  - `0` = current week
82  - `-1` = last week
83  - `-2` = two weeks ago, etc.
84 
85Returns:
86- Total hours for the week
87- Daily breakdown (hours per day)
88- Project breakdown (hours per project)
89- Full list of entries
90 
91### `toggl_last_week`
92Convenience function to get last week's time tracking summary (equivalent to `toggl_weekly` with `week_offset: -1`).
93 
94## Development
95 
96```bash
97# Clone the repo
98git clone https://github.com/louis030195/toggl-mcp.git
99cd toggl-mcp
100 
101# Install dependencies
102npm install
103 
104# Build
105npm run build
106 
107# Run locally
108TOGGL_API_KEY=your-api-key npm start
109```
110 
111## License
112 
113MIT
114 
115## Author
116 
117[Louis Beaumont](https://twitter.com/louis030195)
118