Toggl MCP Server

🚀 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 via natural language. This allows AI assistants to directly manage time entries, projects, and workspaces in Toggl.

🚀 Quick Start

Toggl MCP Server is a Model Context Protocol (MCP) server that allows AI assistants to interact with the Toggl time - tracking API using natural language. This enables AI assistants to directly manage time entries, projects, and workspaces within Toggl.

✨ Features

• Retrieve time entries with filtering options
• Create new time entries
• Update existing time entries
• Delete time entries
• Get the currently running time entry
• Stop the running time entry
• Obtain workspace information
• Get projects in the workspace
• Multi - platform support (linux/amd64, linux/arm64)

💻 Usage Examples

Basic Usage

To connect your AI assistant to this server, configure the MCP connection in your .cursor/mcp.json file:

{
  "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"
      }
    }
  }
}

After configuration, your AI assistant can directly communicate with Toggl through natural - language commands.

🔧 Technical Details

Environment Variables

📄 License

This project is under the MIT License.