Toggl MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Toggl MCP or direct API to track time, fetch activity reports, manage projects, and automate entries through natural language.

Toggl logoToggl
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

Try Toggl now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Toggl
Try asking
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.

SETUP GUIDE

Connect Toggl MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Start a new time entry for project Alpha' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Toggl API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Toggl Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Start a new time entry for design work'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Toggl actions with your Agent

Why Use Composio?

AI Native Toggl Integration

  • Supports both Toggl MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Toggl data

Managed Auth

  • Built-in API key management with secure storage
  • Central place to manage, scope, and revoke Toggl access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Toggl
  • Scoped, least privilege access to Toggl resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Toggl requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Toggl.It takes 30 seconds.

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

Start building