{
  "markdown": "# toggl-mcp\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that gives Claude access to your [Toggl Track](https://toggl.com/track/) time tracking data.\n\nAsk Claude things like:\n- *\"What am I tracking right now?\"*\n- *\"How much time did I spend on each project this week?\"*\n- *\"Start a timer for writing documentation on the Blog project\"*\n- *\"Stop my timer\"*\n- *\"What did I work on yesterday?\"*\n\n---\n\n## Tools\n\n| Tool | What it does |\n|------|-------------|\n| `get_current_timer` | Shows the currently running time entry |\n| `get_recent_entries` | Time entries for the past N days (default 7) |\n| `get_projects` | Lists all your projects |\n| `get_summary` | Total time by project for a date range |\n| `start_timer` | Starts a new time entry |\n| `stop_timer` | Stops the current timer |\n| `get_profile` | Your Toggl profile and workspaces |\n\n---\n\n## Setup\n\n### 1. Get your API token\n\n1. Go to **https://track.toggl.com/profile**\n2. Scroll to the bottom\n3. Click **\"Click to reveal\"** under API Token\n4. Copy the token\n\n### 2. Install\n\n```bash\nnpm install -g toggl-mcp\n```\n\nFind the installed path:\n```bash\nwhich toggl-mcp\n```\n\n### 3. Add to Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"toggl\": {\n      \"command\": \"/path/from/which/toggl-mcp\",\n      \"env\": {\n        \"TOGGL_API_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\nOr if running from source:\n\n```json\n{\n  \"mcpServers\": {\n    \"toggl\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/toggl-mcp/dist/index.js\"],\n      \"env\": {\n        \"TOGGL_API_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You should see a green \"running\" badge in **Settings → Developer**.\n\n### 4. Test it\n\n```\nWhat am I currently tracking in Toggl?\n```\n\n---\n\n## Example queries\n\n**Daily check-in:**\n```\nWhat have I tracked today in Toggl?\n```\n\n**Weekly review:**\n```\nGive me a summary of how I spent my time this week by project\n```\n\n**Start tracking:**\n```\nStart a Toggl timer for \"reviewing PRs\" on my Engineering project\n```\n\n**Stop and summarize:**\n```\nStop my timer and tell me how long I worked\n```\n\n**Productivity analysis:**\n```\nHow much time did I track last week vs the week before?\nWhich project took the most time?\n```\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/yourusername/toggl-mcp\ncd toggl-mcp\nnpm install\nnpm run build\n\n# Test locally\nTOGGL_API_TOKEN=your_token node dist/index.js\n```\n\n### Project structure\n\n```\ntoggl-mcp/\n├── src/\n│   ├── index.ts   # MCP server + tool definitions\n│   └── toggl.ts   # Toggl API v9 client + formatters\n├── package.json\n├── tsconfig.json\n└── README.md\n```\n\n---\n\n## Rate limits\n\nToggl's free plan allows 30 requests/hour per workspace. This MCP server batches calls where possible (e.g. fetching projects and entries in parallel) to stay well within limits for normal use.\n\n---\n\n## Contributing\n\nPRs welcome. Ideas for extension:\n- Tags management\n- Client listing\n- Detailed reports (daily breakdown)\n- Time entry editing\n\n---\n\n## License\n\nMIT\n\n---\n\n## Acknowledgements\n\nBuilt with the [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) and the [Toggl Track API v9](https://engineering.toggl.com/docs/track/).\n",
  "bytes": 3278,
  "sha": "3e72a14c07ece6d23961aaceacd15033c93cc8195e02ffd3fa286462eed6c765",
  "repo_slug": "souravpn/toggl-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_souravpn_toggl_mcp_6a337d1d/readme"
}