Overview
What is Toggl MCP Server?
Allows MCP clients to interact with Toggl Track, enabling time tracking, project management, and workspace operations through natural language.
How to use Toggl MCP Server?
Install Python 3.11+ and uv, clone the repository, set environment variables EMAIL and PASSWORD in a .env file, then run uv pip install --all. Configure the server in any MCP client (e.g., VS Code, Claude Desktop) using stdio transport with the command uv --directory <path> run toggl_mcp_server.py.
Key features of Toggl MCP Server
- Create, delete, and update projects with detailed parameters.
- Create, stop, delete, and update time entries.
- Retrieve all projects or time entries within date ranges.
- Bulk update multiple projects using patch operations.
- Manage workspaces and default to user's default workspace.
Use cases of Toggl MCP Server
- Automate time logging from AI assistants or chatbots.
- Manage project creation and updates through natural language.
- Stop running timers and retrieve current time entry.
- Pull time reports for specific date ranges.
- Bulk update project properties across multiple projects.
FAQ from Toggl MCP Server
What are the prerequisites?
Python 3.11+, a Toggl Track account, and the uv package manager.
How do I set up authentication?
Create a .env file in the mcp_toggl_server folder with your Toggl email and password.
Which MCP clients are supported?
It works with any MCP-compatible client; examples include VS Code (with GitHub Copilot) and Claude Desktop.
What transport does the server use?
The server uses
