toggl-mcp
Enables logging time entries to Toggl Track via MCP tools for listing tags, descriptions, and creating entries, with time conversion from Eastern Time to UTC.
README
Toggl MCP
An MCP (Model Context Protocol) server that lets AI assistants log time entries to Toggl Track.
What it does
Exposes three tools to MCP clients (e.g. Claude):
get_tags— lists existing Toggl tags (cached daily)get_entry_descriptions— lists existing time entry descriptions (cached daily)create_time_entry— logs a new time entry with a start time, end time, description, and tag
Also exposes toggl://tags, toggl://entries, and toggl://now as MCP resources.
Time input is in Eastern Time (America/New_York) and converted to UTC before submission.
Setup
- Copy
.env.exampleto.envand fill in your values:
BASEURL=https://api.track.toggl.com/api/v9/
CACHE_FOLDER=cache
TOGGL_APIKEY=<your api key>
WORKSPACE_ID=<your workspace id>
To find your workspace ID, call the /me endpoint with your API key.
- Install dependencies (requires Python 3.10+):
uv sync
- Run the server:
uv run main.py
MCP Client Config
To use with Claude Desktop, add to your MCP config:
{
"mcpServers": {
"toggl": {
"command": "uv",
"args": ["run", "/path/to/toggl/main.py"]
}
}
}
Running Tests
uv run pytest
Tests live in the tests/ directory. The dev dependency group includes pytest.
Where to get Toggl API Key
- Log in to Toggl Track
- Go to Profile Settings (click your avatar in the bottom-left)
- Scroll to the bottom — your API token is listed under API Token
- Click Click to reveal and copy the token
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.