Overview
What is Toggl MCP Server?
Toggl MCP Server is a Model Context Protocol (MCP) server that enables AI assistants to interact with the Toggl time tracking API. It allows AI assistants to manage time entries, projects, and workspaces in Toggl through natural language.
How to use Toggl MCP Server?
Configure the MCP connection in your .cursor/mcp.json file with the Docker command and set the required TOGGL_API_TOKEN environment variable. Once configured, your AI assistant can interact with Toggl via natural language commands.
Key features of Toggl MCP Server
- Get time entries with filtering options
- Create, update, and delete time entries
- Get and stop the current running time entry
- Retrieve workspace information and workspace projects
- Multi-platform support (linux/amd64, linux/arm64)
Use cases of Toggl MCP Server
- Ask an AI assistant to log time for a specific task
- Retrieve and filter today’s time entries
- Start or stop a running timer through natural language
- Query workspace and project details
- Update or delete a mistaken time entry
FAQ from Toggl MCP Server
How do I set up Toggl MCP Server?
You need to add a configuration entry in .cursor/mcp.json that runs the Docker image lyricrime/toggl-mcp-server and passes the TOGGL_API_TOKEN environment variable. The server is then available for AI assistants to use.
What authentication is required?
You must provide your Toggl API token as the TOGGL_API_TOKEN environment variable. This token is required for the server to authenticate with the Toggl API.
What platforms are supported?
The server supports linux/amd64 and linux/arm64 architectures. It is distributed as a multi‑platform Docker image.
