How to connect Toggl to Claude

Connect Claude Web, Desktop and Cowork to Toggl MCP. Start a new time entry for coding, list all clients in your workspace, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Toggl

Api Key

Toggl is a time tracking platform for managing work hours and productivity. It helps individuals and teams monitor tasks, analyze time usage, and optimize workflows.

56 Tools

Managed auth

Connect Toggl without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Toggl account to Claude via Composio Connect, enabling it to start a new time entry for coding, list all clients in your workspace, get details of your current running timer, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Toggl with

OpenAI Agents SDK Claude Agent SDK Claude Code Codex OpenClaw Hermes Atomic Agent Google ADK LangChain Vercel AI SDK Mastra AI LlamaIndex CrewAI Pydantic AI AutoGen

Connecting Toggl to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash

https://connect.composio.dev/mcp

Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Toggl account

Back in Claude, ask it to connect to Toggl or give it any Toggl-related task.

For example, ask Claude to:

"Start a new time entry for coding"
"List all clients in your workspace"
"Get details of your current running timer"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Toggl account is ready to use.

What is the Toggl Claude Connector, and what's possible with it?

The Toggl MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Toggl account. It provides structured and secure access to your time tracking data, so your agent can perform actions like logging time entries, managing clients and projects, handling tags, and retrieving detailed activity reports on your behalf.

Automated time entry management: Let your agent start, stop, and create new time entries with precise details, making it easy to track your work hours hands-free.
Client and project organization: Easily add new clients or projects, fetch client details, or remove outdated clients to keep your workspace up to date and well-structured.
Real-time activity tracking: Ask your agent to retrieve the currently running time entry or list recent activities, so you always know where your time is going.
Tag management and organization: Automatically create or delete tags to categorize your time entries, helping you analyze how your time is spent across different tasks.
Comprehensive workspace administration: Have your agent create organizations, set up workspaces, and ensure all your time tracking infrastructure is ready to go without manual setup.

Troubleshooting

1. Why does Claude not use the Composio connector for Toggl?

The connector can show as connected, but Claude must use it in each Toggl conversation.

Click + at the lower left of the chat, or type /.
Hover Connectors.
Turn on Composio.
Ask Claude to connect to Toggl again.

2. Why does Claude show an MCP server error before Toggl connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Toggl.

Check that the connector URL is https://connect.composio.dev/mcp.
Connectors run from Anthropic's cloud, so your device network is usually not the problem.
Add the connector again from Customize > Connectors, then ask Claude to connect Toggl.
If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Toggl authorization link not work?

The Composio connector is one server. Your Toggl account connects separately when Claude asks for it.

If the browser does not open, or the link expires, ask Claude to retry the Toggl connection.
Composio creates a fresh Toggl authorization link.
Open that link in your browser and finish the Toggl sign-in.

4. Why do Toggl actions fail after they worked before?

The Toggl connection can expire or lose permission.

Ask Claude to inspect the Toggl connection.
If the connection is unhealthy, disconnect it when Claude prompts you.
Reconnect the Toggl account and retry the action.
If Claude shows a permission prompt, approve it before Claude changes data in Toggl.
If the action still fails with a permission error, check that the connected account has that permission in Toggl itself.

5. How do I switch to a different Toggl account?

Claude can manage the Toggl connection for you.

Ask Claude to disconnect or delete the current Toggl account.
Ask Claude to connect Toggl again.
Open the new Composio authorization link for Toggl.
Sign in with the other Toggl account in the browser.
After the account connects, ask Claude to retry the Toggl task.

6. Why is my Toggl connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Toggl connection works in Claude Web, Desktop, and Cowork.

In Claude Desktop, open Customize > Connectors.
Next to Composio, click ⋮ and click Clear cache.
If Toggl tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Toggl.

TOOLS

Supported Tools

Every Toggl action and event your agent gets out of the box.

Create Client

Tool to create a new client in a workspace.

Create Group

Tool to create a new group in a Toggl organization.

Create Invitation

Tool to send invitations to join a Toggl organization.

Create Organization

Tool to create a new organization with a default workspace in Toggl Track.

Create Project

Creates a new project in a Toggl workspace.

Create Tag

Tool to create a new tag in a workspace.

Create Time Entry

Tool to create a new time entry in the specified workspace.

Add User to Workspace Project

Tool to add a user to workspace project users.

Delete Toggl Client

Tool to delete a client in Toggl.

Delete Group

Tool to delete a group from a Toggl organization.

Delete Project Group

Tool to delete a project group from a Toggl workspace.

Delete Subscription

Tool to delete a webhook subscription in Toggl.

Delete Tag

Deletes a tag from a Toggl workspace.

Disable Weekly Report

Tool to disable weekly report email notifications.

Bulk Edit Time Entries

Tool to bulk edit multiple time entries in a workspace using JSON Patch operations.

Get All Plans

Tool to retrieve all available Toggl subscription plans and their features.

Get Client Details

Retrieves detailed information about a specific client in Toggl Track by its client ID and workspace ID.

Get Countries

Tool to retrieve all countries supported by Toggl.

Get Country Subdivisions

Tool to retrieve all subdivisions (states, provinces, regions) for a specific country in Toggl Track.

Get Currencies

Tool to retrieve the list of all currencies supported by Toggl Track.

Get Current Time Entry

Retrieves the currently running time entry for the authenticated user.

Get Event Filters

Retrieve the list of supported event filters for Toggl webhooks.

Get JWKS Keys

Retrieves the current JWKS (JSON Web Key Set) keyset used to sign JWT tokens.

List Clients

Retrieve a list of clients from a Toggl Track workspace with optional filtering by status and name.

Get My Location

Retrieves the authenticated user's last known location information including city, state, country, and coordinates.

Get My Quota

Tool to retrieve API rate limit quota for the authenticated user.

Get Organization Details

Retrieves detailed information about a specific Toggl organization including subscription plan, trial status, user count, and workspace settings.

Get Organization Groups

Retrieves all groups within a Toggl organization, including group members and workspace assignments.

Get Organization Users

Retrieves a list of users belonging to a Toggl organization.

Get Project Details

Tool to retrieve details of a specific project.

Get Projects

Tool to retrieve a list of projects from a Toggl workspace.

Get Public Subscription Plans

Tool to retrieve all publicly available subscription plans from Toggl.

Get Webhooks Status

Tool to retrieve the Toggl Webhooks server status.

Get Tags

Retrieve all tags in a Toggl workspace.

List Tasks

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

Get Time Entries

Retrieve time entries for the authenticated user with flexible filtering options.

Get Time Entry

Tool to retrieve a specific time entry by its ID.

Get Timezone Offsets

Tool to retrieve all available timezone offsets from Toggl.

Get Timezones

Tool to retrieve all available timezones supported by Toggl Track.

Get User Clients

Retrieves all clients accessible to the authenticated user across all their workspaces.

Get User Preferences

Retrieves the authenticated user's preferences including timezone, date/time formats, notification settings, and enabled alpha/experimental features.

Get User Projects

Tool to retrieve all projects for the authenticated user.

Get User Tags

Tool to retrieve tags associated with the current user.

Get User Tasks

Retrieve all tasks across all workspaces accessible to the authenticated user.

Get User Workspaces

Tool to retrieve all workspaces the authenticated user belongs to.

Get Workspace Details

Retrieves comprehensive details and settings for a specific Toggl workspace by ID.

Get Workspace Logo

Tool to get workspace logo.

Get Workspace Preferences

Retrieves workspace preferences including the initial pricing plan and whether start/end times are hidden.

Get Workspace Users

Retrieves all users who belong to a specific Toggl workspace.

Stop Time Entry

Tool to stop a running time entry in a workspace.

Disable Product Emails

Tool to disable product emails for the authenticated user using a disable code.

Update Tag

Tool to update an existing tag in a specified workspace.

Send Demo Email

Tool to send a demo request email through Toggl's system.

Send Email to Contact

Tool to send an email to a contact via Toggl's smail service.

Send Smail Meet

Tool to send an email for meet.

Update Client

Updates an existing client in a Toggl workspace.

FRAMEWORKS

How to build Toggl MCP Agent with another framework

OpenAI Agents SDK

Use Toggl MCP with OpenAI Agents SDK

Claude Agent SDK

Use Toggl MCP with Claude Agent SDK

Claude Code

Use Toggl MCP with Claude Code

Codex

Use Toggl MCP with Codex

OpenClaw

Use Toggl MCP with OpenClaw

Hermes

Use Toggl MCP with Hermes

Atomic Agent

Use Toggl MCP with Atomic Agent

Google ADK

Use Toggl MCP with Google ADK

LangChain

Use Toggl MCP with LangChain

Vercel AI SDK

Use Toggl MCP with Vercel AI SDK

Mastra AI

Use Toggl MCP with Mastra AI

LlamaIndex

Use Toggl MCP with LlamaIndex

CrewAI

Use Toggl MCP with CrewAI

Pydantic AI

Use Toggl MCP with Pydantic AI

AutoGen

Use Toggl MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Google Sheets

Oauth2

Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.

Notion

Oauth2Api Key

Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.

Airtable

Oauth2Api Key

Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.

Asana

Oauth2

Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals.

FAQ

Frequently asked questions

With a standalone Toggl MCP server, the agents and LLMs can only access a fixed set of Toggl tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Toggl and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Toggl tools.

Yes, absolutely. You can configure which Toggl scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Toggl data and credentials are handled as safely as possible.

Start with Toggl.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Toggl tool your agent needs.Free to start.

Start building

How to connect Toggl to Claude

Connect Toggl without auth hassles

Introduction

Also integrate Toggl with

Connecting Toggl to Claude Web, Desktop, and Cowork

1. Add with one click

Add manually

2. Authorize in your browser

3. Connect your Toggl account

What is the Toggl Claude Connector, and what's possible with it?

Troubleshooting

1. Why does Claude not use the Composio connector for Toggl?

2. Why does Claude show an MCP server error before Toggl connects?

3. Why does the Toggl authorization link not work?

4. Why do Toggl actions fail after they worked before?

5. How do I switch to a different Toggl account?

6. Why is my Toggl connection missing in Claude Desktop or on a Team plan?

Supported Tools

How to build Toggl MCP Agent with another framework

OpenAI Agents SDK

Claude Agent SDK

Claude Code

Codex

OpenClaw

Hermes

Atomic Agent

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Google Sheets

Notion

Airtable

Asana

Frequently asked questions

What are the differences in Tool Router MCP and Toggl MCP?+

Can I use Tool Router MCP with Claude Cowork?+

Can I manage the permissions and scopes for Toggl while using Tool Router?+

How safe is my data with Composio Tool Router?+

Start with Toggl.It takes 30 seconds.