Toggl MCP Server
Allows MCP clients to interact with Toggl Track, enabling time tracking, project management, and workspace operations through natural language.
Усильте агента
Установка от издателя. Не эндпоинт PlugMCP.
Host a copy with our keys and logs.
В реестре пока нет пакетного релиза. Следуйте README репозитория.
Удалённый URL или команда на вашем компьютере? Чем различаются два способа установки
Запустить на PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
ЗапускОт издателя
Allows MCP clients to interact with Toggl Track, enabling time tracking, project management, and workspace operations through natural language.
MCP Server for Toggl
create_project
name (str): The name of the project to be created. This is a required field.workspace_name (str, optional): The name of the workspace where the project will be created. If not provided, it defaults to the user's default workspace.active (bool, optional): Specifies whether the project is active. Defaults to True.billable (bool, optional): Specifies whether the project is billable. Defaults to False.client_id (int, optional): The ID of the client associated with the project.color (str, optional): The hex color code assigned to the project (e.g., "#FF0000").is_private (bool, optional): Specifies whether the project is private. Defaults to True.start_date (str, optional): The start date of the project in ISO 8601 format (e.g., "YYYY-MM-DD").end_date (str, optional): The end date of the project in ISO 8601 format (e.g., "YYYY-MM-DD").estimated_hours (int, optional): The estimated number of hours for the project.template (bool, optional): Specifies whether the project is a template. Defaults to False.template_id (int, optional): The ID of the template to use for creating the project.delete_project
project_name (str): The exact name of the project to be deleted. This is a required field.workspace_name (str, optional): The name of the workspace containing the project. If not provided, it defaults to the user's default workspace.update_projects
project_names (List[str]): A list containing the names of the projects to be updated. This is a required field.operations (List[dict]): A list of patch operations to apply to the selected projects. Each operation is a dictionary specifying the operation type (op), the field path (path), and the new value (value) (e.g., {"op": "replace", "path": "/active", "value": false}). This is a required field.workspace_name (str, optional): The name of the workspace containing the projects. If not provided, it defaults to the user's default workspace.get_all_projects
workspace_name (str, optional): The name of the workspace from which to retrieve projects. If not provided, it defaults to the user's default workspace.new_time_entry
start is provided or neither start nor duration are provided) or log a completed time entry (if start and stop, or start and duration are provided).description (str): The description for the time entry.workspace_name (str, optional): Name of the workspace. Defaults to the user's default workspace.project_name (str, optional): Name of the project to associate the time entry with.tags (List[str], optional): A list of tag names to apply to the time entry.start (str, optional): The start time of the entry in ISO 8601 format (e.g., "2023-10-26T10:00:00Z"). Defaults to the current time if creating a running entry.stop (str, optional): The stop time of the entry in ISO 8601 format. If provided, creates a completed entry.duration (int, optional): The duration of the entry in seconds. If start is provided but stop is not, duration determines the stop time. If start is not provided, a negative duration starts a running timer.billable (bool, optional): Whether the time entry should be marked as billable. Defaults to False.created_with (str, optional): The name of the application creating the entry. Defaults to "MCP".stop_time_entry
workspace_name (str, optional): Name of the workspace where the entry is running. Defaults to the user's default workspace.delete_time_entry
time_entry_description (str): The exact description of the time entry to delete.start_time (str): The exact start time of the entry in ISO 8601 format used for identification.workspace_name (str, optional): Name of the workspace containing the entry. Defaults to the user's default workspace.get_current_time_entry
update_time_entry
time_entry_description (str): The current description of the time entry to update.start_time (str): The exact start time of the entry in ISO 8601 format used for identification.workspace_name (str, optional): Name of the workspace containing the entry. Defaults to the user's default workspace.new_description (str, optional): New description for the time entry.project_name (str, optional): New project name to associate with the entry. Set to empty string "" to remove project association.tags (List[str], optional): A new list of tag names. This will replace all existing tags. Provide an empty list [] to remove all tags.new_start (str, optional): New start time in ISO 8601 format.new_stop (str, optional): New stop time in ISO 8601 format.billable (bool, optional): New billable status.get_time_entries_for_range
from_day_offset (int): The start day offset from today (e.g., 0 for today, -1 for yesterday, -7 for a week ago).to_day_offset (int): The end day offset from today (e.g., 0 for today, 1 for tomorrow). The range includes both the start and end dates.workspace_name (str, optional): Name of the workspace to fetch entries from. Defaults to the user's default workspace.Create a .env file inside of the mcp_toggl_server folder with:
EMAIL=your_toggl_email
PASSWORD=your_toggl_password
If you are using Toggl API tokens:
EMAIL=xxxx
PASSWORD="api_token"
Where xxxx indicates your personal token
First install uv:
- For MacOS/Linux:
bash curl -LsSf https://astral.sh/uv/install.sh | sh
- For Windows:
bash powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Make sure to restart your terminal afterwards to ensure that the uv command gets picked up.
Now let's clone the repository and set up the project:
git clone [repository-url]
cd mcp_toggl_server
uv venv
uv pip install --all
.vscode/mcp.json:"servers": {
"toggl": {
"type": "stdio",
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp_toggl_server",
"run",
"toggl_mcp_server.py"],
"envFile": "${workspaceFolder}/mcp_toggl_server/.env"
}
}
Update the configuration:
/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp_toggl_server with the absolute path to the serverEnable the server:
/.vscode/mcp.jsonFor detailed setup instructions, see:
The Toggl MCP Server works with any MCP-compatible client. For integration steps:
Note: Configuration typically involves specifying the server path and environment variables similar to the VS Code setup above.
To run in development:
EMAIL=your_toggl_email PASSWORD=your_toggl_password mcp dev toggl_mcp_server.py
This MCP server is licensed under the MIT License.
MCP Server for Toggl
Инструменты
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
В этой записи не указано обязательных переменных окружения.
Toggl работает локально через stdio.
Последняя проверка: 2026-10-26. MCP Server for Toggl