How to integrate Toggl MCP with Hermes

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows. This guide explains the easiest and most robust way to connect your Toggl account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

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

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Toggl account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Toggl with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,000+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Toggl with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Toggl

Ask your agent to connect to Toggl, or simply request any Toggl-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Toggl connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Toggl or request any Toggl-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Toggl MCP server, 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.

Way Forward

With Toggl connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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.

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. Hermes 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