Toggl MCP Server

@taiseimiyaji

About Toggl MCP Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "toggl-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TOGGL_API_TOKEN",
        "lyricrime/toggl-mcp-server"
      ],
      "env": {
        "TOGGL_API_TOKEN": "your_toggl_api_token"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.

Can I use

Frequently asked questions

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.