otherapi_key

Toggl

Toggl is a time tracking application that helps users monitor and manage their work hours efficiently.

Verdict

The Toggl MCP lets your team track time, manage projects, and pull billing data without leaving Switchy. @mention it to log hours against a client or project, create new tags on the fly, or pull a breakdown of who worked on what this week. Designers, consultants, and agencies get the most value — anyone billing by the hour or needing visibility into where time goes. You'll need a Toggl API token with workspace access; the MCP can't start or stop a live timer from chat, only create completed entries and read existing data.

Common use cases

  • Log billable hours from standup chat
  • Pull weekly time reports by project
  • Create clients and tags without leaving Slack
  • Audit who tracked time on which task
  • Generate invoices from time entry data

Integration

Vendor
Toggl
Category
other
Auth
API_KEY
Tools
31
Composio slug
toggl

Tools

  • Create Client

    Tool to create a new client in a workspace. use when you need to add a client to a workspace after workspace setup.

  • Create Organization

    Tool to create a new organization with a default workspace. use when initializing a werklog organization and workspace in one step.

  • Create Project

    Tool to create a new project in a workspace. use after confirming workspace id and desired project parameters.

  • Create Tag

    Tool to create a new tag in a workspace. use when you need to add a tag after confirming workspace id and desired tag name.

  • Create Time Entry

    Tool to create a new time entry in the specified workspace. use when you have workspace id, start time, and client name ready.

  • Delete Tag
    destructive

    Tool to delete a tag from a workspace. use when you need to remove an unused tag after confirming its workspace and tag ids.

  • Delete Toggl Client
    destructive

    Tool to delete a client in toggl. use when you have confirmed the workspace and client ids and want to remove a client permanently.

  • Get Client Details

    Tool to retrieve details of a specific client. use when you need to fetch client metadata by its id from toggl.

  • Get Current Time Entry

    Tool to retrieve the current running time entry for the authenticated user. use after starting the timer to fetch the active time entry.

  • Get Organization Details

    Tool to retrieve details of a specific organization by its id. use when you need organizational metadata after confirming the organization id.

  • Get Organization Groups

    Tool to retrieve list of groups in a specified organization. use after confirming organization id.

  • Get Organization Users

    Tool to retrieve all users in a toggl organization by organization id. use after confirming the target organization id.

  • Get Project Details

    Tool to retrieve details of a specific project. use after confirming the workspace id and project id.

  • Get Projects

    Tool to retrieve a list of projects from a toggl workspace. use after confirming workspace id. returns filtered and paginated projects with optional client details.

  • Get Tags

    Tool to retrieve all tags in a toggl workspace. use after confirming the workspace id.

  • Get Time Entries

    Tool to list the latest time entries for the authenticated user. use when you need to fetch or filter your logged time entries by start date or end date.

  • Get Time Entry

    Tool to retrieve a specific time entry by its id. use when you have the entry id and need its full details.

  • Get User Clients

    Tool to fetch the list of clients accessible by the authenticated user. use when you need to see all clients available to the current toggl user.

  • Get User Preferences

    Tool to retrieve current user's preferences and alpha features. use when you need to access user settings for customized experiences.

  • Get User Projects

    Tool to retrieve all projects for the authenticated user. use after authenticating to list available projects.

  • Get User Tags

    Tool to retrieve tags associated with the current user. use when you need to list all tags visible to your account.

  • Get User Tasks

    Tool to retrieve tasks from projects in which the authenticated user is participating. use after authenticating to list all tasks across workspaces.

  • Get User Workspaces

    Tool to retrieve all workspaces the authenticated user belongs to. use when you need to list accessible workspaces before performing workspace-specific operations.

  • Get Workspace Details

    Tool to retrieve details of a specific workspace. use when you need to fetch workspace configuration and settings by its id.

  • Get Workspace Preferences

    Tool to retrieve workspace preferences. use after confirming workspace id to inspect settings like week start, project creation rules, and time tracking options.

  • Get Workspace Users

    Tool to retrieve all users in a toggl workspace by workspace id. use after confirming the target workspace id.

  • List Clients

    Tool to retrieve a list of clients from a toggl workspace. use when you need to list all clients with optional filters.

  • List Tasks

    Tool to list tasks in a workspace or within a specific project.

  • Stop Time Entry

    Tool to stop a running time entry in a workspace. use when a time entry needs to be ended.

  • Update Client

    Tool to update details of a specific client. use when you need to modify a client's name, notes, or other details after confirming workspace and client ids.

  • Update Tag

    Tool to update an existing tag in a specified workspace. use after confirming the workspace id and tag id when renaming a tag. example: rename tag 'urgent' to 'high priority'.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and click 'Add Integration' under the MCP section. 2. Select Toggl from the list and choose API Key as the auth method. 3. Open Toggl in a new tab, navigate to your profile settings, and copy your API token from the API Token section at the bottom of the page. 4. Paste the token into Switchy's auth prompt and confirm. 5. Switchy will verify the connection by fetching your workspaces; if successful, you'll see a green checkmark. 6. Inside any Space, type '@Toggl list my workspaces' and send — if the MCP replies with workspace names and IDs, you're connected. 7. To log time, @mention Toggl with a start time, duration, and project or client name; the MCP will create the entry and confirm the ID.

What teammates see: by default, memories from Toggl are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Log Yesterday's Work

@Toggl create a time entry for yesterday from 9am to 11:30am, project 'Website Redesign', description 'Wireframe revisions for homepage'.
Open in a Space →

Weekly Team Breakdown

@Toggl show me all time entries from the past 7 days, grouped by user and project, with total hours for each.
Open in a Space →

Add New Client

@Toggl create a new client called 'Acme Corp' in workspace ID 123456, then confirm the client ID.
Open in a Space →

Tag Sprint Tasks

@Toggl create a tag called 'Sprint 12' in workspace ID 123456, then list all existing tags to confirm.
Open in a Space →

Audit Project Hours

@Toggl get all time entries for project ID 789012 from the last 30 days, include user names and descriptions.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@toggl show me all time entries I logged last week, grouped by project

Output

Here's your time breakdown for last week (Dec 9-15): **Website Redesign** logged 18.5 hours across 12 entries; **Client Onboarding** logged 6 hours in 4 sessions; **Internal Meetings** logged 3.5 hours. Your longest single session was 4 hours on the redesign Thursday afternoon. Total tracked: 28 hours. Note: This is an illustrative summary—actual output depends on your Toggl workspace data and entry descriptions.

Notes

This example shows the MCP's read capability for time entries. Requires a valid API key with read access to your workspace. Toggl's API returns raw entry data; the AI synthesizes it into a readable summary. If you have multiple workspaces, specify which one to query.

Prompt

@toggl start a new time entry for 'Q1 Planning' under the Strategy project, tag it as 'leadership'

Output

Time entry started at 2:47 PM for project 'Strategy' with description 'Q1 Planning' and tag 'leadership'. Entry ID: 2847561923. The timer is now running in your Toggl workspace. To stop it, either use the Toggl app or ask me to stop the current entry. This is an illustrative confirmation—actual IDs and timestamps reflect your live workspace state.

Notes

This demonstrates the MCP's write capability to create time entries. The MCP can start timers but won't auto-stop them—you must manually stop or the entry runs indefinitely. Requires workspace ID and valid project/tag names; the MCP will error if those don't exist in your workspace.

Prompt

@toggl review my time allocation this month and tell me if I'm spending too much on internal meetings versus client work

Output

Analyzing your December entries: **Internal Meetings** consumed 34% of tracked time (41 hours), while **Client Work** (projects tagged 'billable') totaled 52% (63 hours). The remaining 14% went to admin tasks. Your meeting load is above the typical 25-30% benchmark for client-facing roles. Consider blocking focus time or declining non-critical meetings. This analysis is illustrative—actual percentages depend on your tagging and project setup.

Notes

This example pairs Toggl's data retrieval with the AI's analytical reasoning. The insight quality depends on how consistently you tag entries and categorize projects. The MCP fetches raw time data; the AI interprets patterns. No side-effects—this is read-only analysis.

Use-case deep-dives

Freelancer client billing reconciliation

When Toggl MCP beats manual time-entry for solo consultants

A freelance designer juggling four active clients needs to export time entries by client and project at month-end for invoicing. The Toggl MCP wins here because it exposes 31 tools that let you script the entire workflow: pull time entries by client, filter by date range, aggregate hours, and cross-reference project tags—all in one AI conversation instead of clicking through the Toggl web UI five times per client. The API key auth is straightforward for a solo operator. The trade-off: if you're only tracking time for yourself and billing one flat rate, the MCP is overkill—just use Toggl's native export. But if you're reconciling multiple clients with overlapping projects and need to slice time data in different ways each month, this MCP turns a 20-minute manual task into a 2-minute prompt.

Agency project setup automation

Toggl MCP for onboarding new client projects at scale

A 12-person creative agency onboards three new clients per month, each requiring a Toggl workspace, client record, project structure, and tag taxonomy. The Toggl MCP's Create Organization, Create Client, Create Project, and Create Tag tools let you template the entire setup in a single AI workflow—no more copying last month's structure by hand or training junior PMs on Toggl's admin UI. The 31-tool surface area means you can also script cleanup: delete unused tags, archive old clients, and audit time-entry consistency across the team. The boundary: if your agency is under five people and onboards one client per quarter, the manual UI is faster. But at 10+ people with regular client churn, this MCP pays for itself in the first week by eliminating setup busywork and keeping your Toggl org tidy.

Support team capacity planning

When Toggl MCP helps forecast support load from time data

A six-person customer support team tracks time in Toggl by ticket category (bug, feature request, onboarding) and wants to forecast next quarter's headcount needs based on actual time spent per category. The Toggl MCP's Get Client Details and time-entry retrieval tools let you pull historical data, group by tag, and feed it into a capacity model—all without exporting CSVs or writing custom API scripts. The 31 tools give you enough flexibility to slice time data by workspace, project, and tag in the same conversation where you're building the forecast. The catch: if your support team is under four people or you're only tracking total hours (not categorized time), the native Toggl reports are sufficient. But if you're planning headcount or rebalancing workload across categories, this MCP turns Toggl into a planning input instead of just a timesheet.

Frequently asked

What does the Toggl MCP let me do in Switchy?

It lets your AI assistant create time entries, manage projects and clients, and pull reports from your Toggl workspace. You can ask the assistant to log hours for a task, check which projects are active, or create a new client without opening Toggl. The MCP handles all 31 Toggl API operations, so you can automate most time-tracking workflows through conversation.

Do I need a Toggl API key to connect this MCP?

Yes. The Toggl MCP uses API key authentication, which you generate from your Toggl profile settings. You'll paste that key into Switchy once; the assistant uses it for every request. If your team shares a Toggl workspace, only the person who connects the MCP needs admin access to generate the key—other teammates just use the assistant.

Can the MCP edit or delete existing time entries?

The representative tool list shows create and delete operations for clients, projects, and tags, but doesn't explicitly list time-entry editing. Toggl's API does support updating entries, so check the full tool manifest in Switchy to confirm. If editing isn't exposed, you'll still create new entries and delete mistakes through the assistant—just not modify them in place.

Why use this instead of the Toggl web app or mobile app?

Use the MCP when you're already working in Switchy and want to log time without context-switching. If you're reviewing a project in Notion or Slack and realize you forgot to track hours, the assistant can create the entry inline. The Toggl app is still faster for bulk edits or visual timeline views; the MCP wins for conversational, interrupt-free logging.

Who on the team should connect the Toggl MCP?

Whoever owns your Toggl workspace setup and has an API key. That's usually a project manager or ops lead. Once connected, every Switchy user in your workspace can ask the assistant to interact with Toggl—they don't need their own API keys. Just make sure the connecting person's Toggl permissions cover the workspaces your team tracks time against.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.