toggl-mcp

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.

Category
Visit Server

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

  1. Copy .env.example to .env and 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.

  1. Install dependencies (requires Python 3.10+):
uv sync
  1. 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

  1. Log in to Toggl Track
  2. Go to Profile Settings (click your avatar in the bottom-left)
  3. Scroll to the bottom — your API token is listed under API Token
  4. Click Click to reveal and copy the token

Recommended Servers

playwright-mcp

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.

Official
Featured
TypeScript
Magic Component Platform (MCP)

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.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

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.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

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.

Official
Featured
TypeScript
Kagi MCP Server

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.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

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.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured