Toggl
Toggl is a time tracking application that helps users monitor and manage their work hours efficiently.
Verdict
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 Tagdestructive
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 Clientdestructive
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
- 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
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.
@toggl show me all time entries I logged last week, grouped by project
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.
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.
@toggl start a new time entry for 'Q1 Planning' under the Strategy project, tag it as 'leadership'
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.
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.
@toggl review my time allocation this month and tell me if I'm spending too much on internal meetings versus client work
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.
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
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.
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.
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.