KosmoKrator

productivity

Toggl Track MCP Integration for Claude Agent SDK

Connect Toggl Track to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write API token auth
Submit Toggl Track feedback View package source

Connect Toggl Track to Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Toggl Track MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "mcpServers": {
    "kosmokrator-toggl-track": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=toggl-track",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=toggl-track --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Toggl Track instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Toggl Track Tools Visible to Claude Agent SDK

Claude Agent SDK sees stable MCP tool names generated from the Toggl Track integration catalog.

MCP toolSource functionTypeDescription
integration__toggl_track__toggl_list_time_entries toggl-track.toggl_list_time_entries Read List time entries from Toggl Track. Filter by date range, workspace, or project. Returns recent time entries by default.
integration__toggl_track__toggl_get_time_entry toggl-track.toggl_get_time_entry Read Get detailed information about a specific Toggl Track time entry by its ID.
integration__toggl_track__toggl_create_time_entry toggl-track.toggl_create_time_entry Write Create a new time entry in Toggl Track. Provide a description, workspace, start time, and duration. Optionally assign to a project, add tags, or mark as billable.
integration__toggl_track__toggl_list_projects toggl-track.toggl_list_projects Read List projects from Toggl Track. Optionally filter by workspace or active status.
integration__toggl_track__toggl_get_project toggl-track.toggl_get_project Read Get detailed information about a specific Toggl Track project by its ID.
integration__toggl_track__toggl_list_workspaces toggl-track.toggl_list_workspaces Read List all Toggl Track workspaces accessible to the authenticated user. Returns workspace IDs and names needed for other operations.
integration__toggl_track__toggl_get_current_user toggl-track.toggl_get_current_user Read Get the authenticated Toggl Track user profile, including email, name, default workspace, and time zone.

Related Toggl Track Pages

Toggl Track CLIUse direct JSON commands instead of MCP discovery. Toggl Track MCPFull gateway reference and MCP tool names. KosmoKrator for Claude Agent SDKClient-level gateway setup.