Toggl Track
Toggl Track is a time tracking platform for recording work, managing projects and workspaces, producing reports, and configuring webhooks.
Verdict
Common use cases
- Log billable hours during client calls
- Bulk-update time entry descriptions after sprint
- Start and stop timers from chat
- Create projects for new client engagements
- Generate weekly time summaries for invoicing
Integration
- Vendor
- Toggl Track
- Category
- other
- Auth
- API_KEY
- Tools
- 21
- Composio slug
toggl_track
Tools
- Bulk Update Time Entries
Apply the same description and/or billable state to 1 to 100 Toggl Track time entries in one provider-native request. Updates are non-atomic: Toggl Track performs no transaction or rollback, so some IDs can succeed while others fail; always
- Create Client
Create a client in a workspace for grouping projects.
- Create Project
Create a project in a workspace for organizing time entries and tasks.
- Create Task
Create a task under an active project for more specific time-entry assignment.
- Create Time Entry
Create a running or completed time entry in a workspace; omit duration and stop to start a running timer. Supplying tag names may also create tags that do not yet exist.
- Delete Clientdestructive
Permanently delete one client from a Toggl Track workspace.
- Delete Projectdestructive
Delete one project while preserving its time entries by unassigning them from the project.
- Delete Taskdestructive
Permanently delete one task from its parent project.
- Delete Time Entrydestructive
Permanently delete one time entry from a workspace.
- Get Current Time Entry
Return the currently running time entry for the connected user, or indicate that no timer is running.
- Get Current User
Return the connected Toggl Track user's identity and defaults, including the default workspace ID, without exposing credentials.
- Get Time Entry
Get one time entry by ID, with optional related-entity and sharing metadata.
- List Time Entries
List the connected user's time entries in an explicit date range, optionally including related project, task, user, and sharing metadata.
- List Workspace Resources
Find projects, clients, tags, or tasks in a workspace and return their IDs for time-entry and resource-management tools.
- List Workspaces
List workspaces accessible to the connected user and return the IDs needed by workspace-scoped tools, without exposing private tokens or calendar URLs.
- Run Detailed Time Report
Return one page of detailed, grouped time-entry report rows for a workspace and date range, with an opaque cursor for the next page.
- Stop Time Entry
Stop a currently running time entry and return its finalized timing data.
- Update Client
Update a client's name, notes, or external reference. Toggl Track requires the client's name on every update, even when it is unchanged.
- Update Project
Update a project's name, client, active state, privacy, color, or date range.
- Update Task
Update a task's name, completion state, estimate, assignee, or external reference.
- Update Time Entry
Update the timing, description, assignment, billable state, or tags of an existing time entry. Provide at least one change; changing tags requires tag_action together with tags or tag_ids. Tag effects are verified against the returned time
Setup
Setup guide
- 11. In Switchy, open Workspace Settings and click Add Integration under MCP Servers. 2. Select Toggl Track from the catalog. 3. Go to your Toggl Track profile settings (toggl.com/app/profile), scroll to API Token, and copy the token. 4. Paste the token into Switchy's API Key field and click Connect. 5. Switchy will verify the connection by fetching your workspace list. 6. Inside any Project, type '@Toggl Track create a time entry for client onboarding, 2 hours, billable' and send the message. 7. Check your Toggl Track workspace to confirm the entry appears with the correct description, duration, and billable flag. 8. You can now @mention Toggl Track to start timers, bulk-update entries, or create projects and tasks without leaving Switchy.
What teammates see: by default, memories from Toggl Track are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Log Billable Meeting
@Toggl Track create a time entry for 'Client discovery call with Acme Corp', 1.5 hours, billable, tagged 'consulting'.
Start Feature Timer
@Toggl Track start a timer for 'Implement OAuth flow for dashboard' under the Platform Rebuild project.
Bulk Fix Descriptions
@Toggl Track find all time entries from last week tagged 'bug-fix' and update their descriptions to 'Production hotfix deployment'.
New Client Setup
@Toggl Track create a client named 'Beta Industries' and a project called 'Q1 Retainer' under that client in my main workspace.
Weekly Hours Summary
@Toggl Track list all my time entries from Monday to today, group by project, and show total hours for each.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Toggl Track show me all time entries from last week grouped by project, and calculate total billable hours
Here's your time tracking summary for last week: **Website Redesign** (Client: Acme Corp) - 18.5 hours total, 16.0 billable - Top tasks: wireframing (6h), client reviews (4.5h) **Internal Tools** (No client) - 12.0 hours total, 0 billable - Mostly documentation and refactoring **Support Tickets** (Client: Beta Industries) - 8.5 hours total, 8.5 billable Total billable: 24.5 hours across 2 clients. Your utilization rate was 62% last week.
This example combines list-and-filter operations with AI synthesis. The MCP fetches raw time entries; the AI groups, sums, and formats them. Requires read access to time entries across the workspace. Note that Toggl's API returns entries in UTC, so week boundaries depend on your account's timezone setting.
@Toggl Track I just finished a 2-hour design session for the mobile app project, mark it billable and tag it 'UI work'
Time entry created: - Project: Mobile App Redesign - Duration: 2 hours (stopped at 3:47 PM) - Description: "Design session" - Billable: Yes - Tags: UI work (tag created automatically) This entry is now visible in your Toggl Track workspace and will appear on client invoices if you're using Toggl's reporting features.
Demonstrates the create-time-entry tool with automatic tag creation. The MCP stops a running timer and applies metadata in one call. If the project name is ambiguous or doesn't exist, the operation fails—Toggl requires exact project IDs. The 'billable' flag only matters if your workspace has that feature enabled.
@Toggl Track find all unbilled time entries for Acme Corp from this month and draft an invoice summary
Found 14 unbilled time entries for Acme Corp (March 2025): **Website Redesign** – 22.5 hours @ $150/hr = $3,375 - Wireframing & prototyping: 9h - Client feedback rounds: 6.5h - Asset preparation: 7h **API Integration** – 11.0 hours @ $150/hr = $1,650 - Endpoint development: 8h - Testing & documentation: 3h **Total due: $5,025** (33.5 billable hours) Ready to mark these as billed? I can bulk-update all 14 entries to prevent double-billing.
Showcases read-then-reason workflow: the MCP filters by client and billing status, the AI structures an invoice. The bulk-update offer is real—Toggl's API supports non-atomic batch updates, meaning partial failures are possible if some entry IDs become invalid mid-request. Always verify in Toggl's UI before sending to clients.
Use-case deep-dives
When Toggl Track beats spreadsheets for monthly invoicing
A 6-person design agency bills three retainer clients and four project clients every month. They need to reconcile who worked on what, apply the correct billable rates, and export clean invoices. Toggl Track wins here because the Create Client and Create Project tools let you mirror your actual client structure, then Bulk Update Time Entries fixes mistakes in one call instead of 47 manual edits. The 21-tool scope gives you enough control to automate the full cycle: create entries during the work week, bulk-tag them by client on Friday, then pull reports on the first of the month. If your team forgets to log time more than twice a week, this MCP won't save you—garbage in, garbage out. But if logging is a habit, Toggl Track's MCP turns your time data into invoices without touching a spreadsheet.
Why solo consultants should skip this MCP
A solo consultant juggles five clients and wants to see where the hours actually go each quarter. Toggl Track's MCP is overkill. The 21 tools are built for team coordination—creating clients, projects, tasks, and bulk-updating entries across multiple people. A single freelancer doesn't need Create Task or Bulk Update Time Entries; they need a simple start/stop timer and a quarterly export. The API_KEY auth is fine, but you're paying the cognitive overhead of 21 endpoints when you'll use three. Toggl's native mobile app or a lightweight integration like Zapier handles this scenario better. Save the MCP for when you hire your second person and need to split project time across two calendars. Until then, this is a Civic when you need a bicycle.
When this MCP clarifies where your two-week sprint went
A 5-person product team runs two-week sprints and wants to know why estimation keeps missing by 40 percent. They log time in Toggl Track during the sprint, tagging entries by feature or bug fix. At retro, they pull the data through the MCP to compare estimated versus actual hours per task. The Create Time Entry and Create Task tools let you structure entries around your sprint board without leaving your workflow. The real win is visibility: you see that backend tasks consistently take twice as long as estimated, or that one engineer spends 30 percent of the sprint in unplanned support work. If your team doesn't log time within 24 hours of doing the work, the data will be fiction. But if logging is part of your sprint hygiene, this MCP turns Toggl Track into a retro truth-teller instead of a compliance checkbox.
Frequently asked
What does the Toggl Track MCP do in Switchy?
It lets AI agents create, update, and delete time entries, projects, clients, and tasks directly in your Toggl Track workspace. Agents can start timers, bulk-edit descriptions across dozens of entries, or pull reporting data without you switching tabs. Useful for logging meeting time, syncing project work from other tools, or automating timesheets.
Do I need admin access to connect Toggl Track?
You need a Toggl Track API key, which any workspace member can generate from their profile settings. The MCP inherits that user's permissions—if you can't create projects in the Toggl UI, the agent can't either. Admin rights aren't required unless you want the agent to manage workspace-wide clients or billing settings.
Can the MCP edit time entries I already logged manually?
Yes. The bulk-update tool can change descriptions or billable flags on up to 100 entries at once, and individual tools let you modify start time, duration, or project assignment. Toggl Track doesn't support transactions, so if a bulk update fails halfway through, some entries stay changed and others don't—no rollback.
Should I use this MCP or just call Toggl's API directly?
Use the MCP if you want natural-language control—tell an agent "log two hours to Project X" instead of writing JSON payloads. Use the API directly if you're building a custom integration with strict error handling, because Toggl's bulk operations don't roll back on partial failure and the MCP won't add transaction logic the vendor doesn't provide.
Who on my team should connect the Toggl Track MCP?
Whoever owns time-entry hygiene or project setup. If one person reviews timesheets weekly, connect their Toggl account so agents can bulk-fix missing descriptions. If your PM creates all projects, use theirs. Each connection uses one API key, so you can add multiple team members' accounts if different people manage different workspaces.