Time Management

Toggl MCP Server

Connect your account, then chat with AI to run tools.

Let AI agents read Toggl organizations and time entries, inspect projects and clients, and log or adjust billable hours without leaving chat.

Best forAgenciesConsultantsFreelancersOperations Managers

Try this workflow

Weekly time review

Pull my Toggl time entries from the last seven days, group hours by project, and flag any days under six billable hours.

Start chatting
Managed
16 tools
Agent guide included

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

What you can do with Toggl

Built for

Agencies, Consultants, Freelancers, Operations Managers, Team Leads

Example workflows

Weekly time review

Common utilization check — starts from time entries then summarizes.

Try this

Pull my Toggl time entries from the last seven days, group hours by project, and flag any days under six billable hours.

Client project inventory

Billing prep — needs workspace context then clients and projects.

Try this

List Toggl clients and their active projects in my workspace, with project ids and billable flags.

Log billable work

Shows create semantics with explicit project linkage.

Try this

Create a two-hour billable Toggl time entry for project id 12345 starting today at 9:00 UTC with description 'Client workshop prep'.

Org membership audit

Admin workflow — organization read before org-scoped user read.

Try this

List my Toggl organizations and the users in the first organization — summarize names and roles.

Context to know first

What can AI agents do with Toggl Track?

Agents can read organizations, groups, users, time entries, workspace statistics, clients, projects, and tasks. They can also create or update time entries, clients, projects, and tasks, and delete those rows when you ask explicitly.

How does Toggl authentication work on MCPBundles?

Connect with your Toggl Track email and API token using Basic auth. Agents then operate on the organizations and workspaces your account can access.

Why do agents need workspace_id for most Toggl reads?

Toggl Track scopes clients, projects, tasks, and writes under a workspace. Time entries include workspace_id — agents use that to anchor project and client reads without guessing.

AI Skill
SKILL.md

Domain knowledge for Toggl — workflow patterns, data models, and gotchas for your AI agent.

Toggl Track

Toggl Track organizes time under Organizations and Workspaces. Workspaces contain Projects, Clients, and Tasks. Time entries log hours against projects and tasks.

The MCP surface targets Toggl Track API v9 at api.track.toggl.com with Basic auth (email + API token).

Hierarchy

  • Organization — top-level billing and membership container.
  • Workspace — where projects, clients, tasks, and time entries live.
  • Client — billing grouping for projects.
  • Project — time-allocation container; may link to a client.
  • Task — sub-item under a project (premium workspaces).
  • Time entry — logged interval with start/stop, description, billable flag, tags.

Operational order

  1. Read organizations first (no organization id) to discover organization and workspace context.
  2. Read time entries — recent entries include workspace_id for downstream workspace-scoped reads.
  3. Resolve workspace_id before clients, projects, tasks, statistics, or writes.
  4. Read projects and clients before creating time entries that reference them.
  5. For a single task fetch, pass both project_id and task id — tasks are project-scoped upstream.

Write semantics

  • Time entry create — POST under a workspace; start is required on create; created_with is set automatically when omitted.
  • Time entry update — PUT with time entry id and the same workspace_id.
  • Client / project / task create — POST with workspace_id (and project_id for tasks); name required on create.
  • Updates — PUT with resource id; only send fields you intend to change.
  • Deletes — DELETE with workspace-scoped ids; destructive and idempotent.

Gotchas

  • Organization list uses the user-scoped /me/organizations route — not /organizations without an id.
  • Newly created organizations, workspaces, or projects may take a few seconds to appear in session — retry reads if a just-created id 404s.
  • Task listing at workspace scope paginates (page, per_page); single-task fetch requires project_id.
  • User-scoped routes (/me/time_entries) are rate-limited separately from workspace routes.

Tools in this Server (16)

Toggl Delete Client

Delete a Toggl Track client by id within a workspace. Requires workspace_id and id. Destructive and idempotent.

Toggl Delete Project

Delete a Toggl Track project by id within a workspace. Requires workspace_id and id. Destructive and idempotent.

Toggl Delete Task

Delete a Toggl Track task by id within a project. Requires workspace_id, project_id, and id. Destructive and idempotent.

Toggl Delete Time Entry

Delete a Toggl Track time entry by id within a workspace. Requires workspace_id and id. Destructive and idempotent — repeating delete on the same id i...

Toggl Get Clients

Read clients in a Toggl Track workspace. Requires workspace_id. Omit id to list clients (optional status and name filters). Pass id to fetch one clien...

Toggl Get Organization Groups

Read groups within a Toggl Track organization. Requires organization_id from an organization read first. Returns group names and member counts for tea...

Toggl Get Organizations

Read Toggl Track organizations your account belongs to. Omit organization_id to list every organization (user-scoped route). Pass organization_id to f...

Toggl Get Organization Users

Read users in a Toggl Track organization. Requires organization_id from an organization read first. Returns member names, roles, and profile metadata.

Toggl Get Projects

Read projects in a Toggl Track workspace. Requires workspace_id. Omit id to list projects. Pass id to fetch one project with status, client linkage, a...

Toggl Get Tasks

Read tasks in a Toggl Track workspace. Requires workspace_id. Omit id to list workspace tasks with pagination (page, per_page, pid, search filters). T...

Toggl Get Time Entries

Read Toggl Track time entries for the authenticated user. Omit id to list recent entries (optional start_date, end_date, before, since filters). Pass ...

Toggl Get Workspace Statistics

Read aggregated productivity statistics for a Toggl Track workspace. Requires workspace_id from a time entry or organization context. Returns tracked ...

Toggl Upsert Client

Create or update a Toggl Track client in a workspace. Omit id to create (name required on create). Pass id to update name, notes, or external_referenc...

Toggl Upsert Project

Create or update a Toggl Track project in a workspace. Omit id to create (name required on create). Pass id to update name, client_id, billable flag, ...

Toggl Upsert Task

Create or update a Toggl Track task under a project. Requires workspace_id and project_id. Omit id to create (name required on create). Pass id to upd...

Toggl Upsert Time Entry

Create or update a Toggl Track time entry in a workspace. Omit id to create (start is required on create; workspace_id is always required). Pass id to...

Frequently Asked Questions

What can AI agents do with Toggl Track?

Agents can read organizations, groups, users, time entries, workspace statistics, clients, projects, and tasks. They can also create or update time entries, clients, projects, and tasks, and delete those rows when you ask explicitly.

How does Toggl authentication work on MCPBundles?

Connect with your Toggl Track email and API token using Basic auth. Agents then operate on the organizations and workspaces your account can access.

Why do agents need workspace_id for most Toggl reads?

Toggl Track scopes clients, projects, tasks, and writes under a workspace. Time entries include workspace_id — agents use that to anchor project and client reads without guessing.

How do I connect Toggl to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/toggl. Authentication is handled automatically.

How many tools does Toggl provide?

Toggl provides 16 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Toggl require?

Toggl uses API Key. Toggl requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Toggl to any MCP client in minutes

MCP URL
https://mcp.mcpbundles.com/bundle/toggl
Claude.aiCursorVS CodeVS Code InsidersGooseLM StudioCherry StudioChatGPT

One-click install:

Install on Claude.aiInstall for organization (admins)

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Toggl and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Toggl will appear under Not connected — select it and click Connect to complete OAuth.
Name: Toggl
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/toggl
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Related MCP Servers

More time management integrations you might like

Insightful

Insightful is a workforce productivity and time-tracking platform for monitoring employee activity, ...

15 tools
Time Management
Google Calendar

Google Calendar is a time management and scheduling service that allows users to create, share, and ...

11 tools
Time Management
OnceHub

Oncehub offers integrated scheduling solutions and appointment management through its API, facilitat...

7 tools
Time Management
Everhour

Everhour is a time tracking platform with project budgeting, expense tracking, scheduling, and invoi...

33 tools
Time Management
7shifts

7shifts is a workforce management platform designed for restaurants, enabling users to schedule staf...

76 tools
Time Management
Cal.com

Cal.com is an open-source scheduling platform for managing appointments, availability, and calendar ...

15 tools
Time Management

Ready to use Toggl?

Sign in to connect your credentials and start running tools from the chat.

Toggl Track MCP Server — Time Tracking for AI Agents