Toggl MCP Server

Allows MCP clients to interact with Toggl Track, enabling time tracking, project management, and workspace operations through natural language.

Features

Tools

Project Management

• create_project

  • Description: Creates a new project in a specified Toggl workspace.
  • Input:
    • 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.
  • Output: JSON response containing the data of the newly created project.

• delete_project

  • Description: Deletes a project identified by its name within a specified workspace.
  • Input:
    • 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.
  • Output: A confirmation message (str) indicating the successful deletion of the project.

• update_projects

  • Description: Performs bulk updates on multiple projects within a specified workspace using patch operations.
  • Input:
    • 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.
  • Output: JSON response containing the data of the updated projects.

• get_all_projects