KosmoKrator

productivity

Toggl Track MCP Integration for OpenAI Agents SDK

Connect Toggl Track to OpenAI Agents 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 OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Toggl Track MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "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 OpenAI Agents

OpenAI Agents 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 OpenAI AgentsClient-level gateway setup.