Toggl MCP Server

by taiseimiyaji

22 stars

492 downloads

Not rated

GitHub

Other

Description

# Toggl MCP Server *Read this in: [English](#english) | [日本語](#japanese)* <a id="english"></a> ## English ### Overview Toggl MCP Server is a Model Context Protocol (MCP) server that allows AI assistants to interact with the Toggl time tracking API. This enables AI assistants to…

About

Details

Author: taiseimiyaji
GitHub stars: 22
Downloads: 492
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Toggl MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

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

Toggl MCP Server

Read this in: English | 日本語

English

Overview

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

Features

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

Usage

MCP Configuration

To connect an 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"
      }
    }
  }
}

Once configured, your AI assistant can interact with Toggl directly through natural language commands.

Environment Variables

- TOGGL_API_TOKEN (required): Your Toggl API token for authentication

License

MIT License

---

日本語

概要

Toggl MCP Serverは、AIアシスタントがTogglのタイム・トラッキングAPIと対話できるようにするModel Context Protocol (MCP)サーバーです。これにより、AIアシスタントは自然言語を通じてTogglのタイムエントリー、プロジェクト、ワークスペースを直接管理できるようになります。

機能

- フィルタリングオプション付きのタイムエントリー取得 - 新規タイムエントリーの作成 - 既存タイムエントリーの更新 - タイムエントリーの削除 - 現在実行中のタイムエントリーの取得 - 実行中のタイムエントリーの停止 - ワークスペース情報の取得 - ワークスペース内のプロジェクト取得 - マルチプラットフォームサポート（linux/amd64, linux/arm64）

使用方法

MCP設定

AIアシスタントをこのサーバーに接続するには、.cursor/mcp.jsonファイルにMCP接続を以下のように設定します：

{
  "mcpServers": {
    "toggl-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TOGGL_API_TOKEN",
        "lyricrime/toggl-mcp-server"
      ],
      "env": {
        "TOGGL_API_TOKEN": "あなたのTogglAPIトークン"
      }
    }
  }
}

設定が完了すれば、AIアシスタントは自然言語コマンドを通じて直接Togglと対話できるようになります。

環境変数

- TOGGL_API_TOKEN（必須）：認証用のToggl APIトークン

ライセンス

MITライセンス

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Toggl MCP Server

English

Overview

Features

Usage

MCP Configuration

Environment Variables

License

日本語

概要

機能

使用方法

MCP設定

環境変数

ライセンス

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀