Skip to main content
Glama

Tempus MCP ⏱️

Tempus (Latin for "time") — An MCP server for Toggl Track.

A Model Context Protocol (MCP) server that provides AI assistants with full access to your Toggl Track time tracking data. Create time entries for past dates, manage projects, query workspaces, and more — all through natural language.

Tools

Time Entries

Tool

Description

toggl_list_time_entries

List time entries with optional date filtering

toggl_get_current_time_entry

Get the currently running time entry

toggl_create_time_entry

Create time entries for any date (past or future) with project assignment, tags, and billable status

toggl_update_time_entry

Update existing time entries (description, project, start/stop, duration)

toggl_delete_time_entry

Permanently delete a time entry

toggl_stop_time_entry

Stop a running time entry

Projects

Tool

Description

toggl_list_projects

List all projects in a workspace

toggl_get_project

Get a single project by ID

toggl_create_project

Create a new project

Workspaces & User

Tool

Description

toggl_list_workspaces

List all accessible workspaces

toggl_get_workspace

Get workspace details

toggl_get_me

Get authenticated user profile

toggl_list_clients

List clients in a workspace

Related MCP server: Toggl MCP Server

Installation

npm install -g tempus-mcp
# or
npx tempus-mcp

Usage

1. Get your Toggl API Token

Go to https://track.toggl.com/profile and copy your API token.

2. Run the MCP server

export TOGGL_API_TOKEN="your_token_here"
tempus-mcp

3. Configure your MCP client

Claude Desktop:

{
  "mcpServers": {
    "tempus": {
      "command": "tempus-mcp",
      "env": {
        "TOGGL_API_TOKEN": "your_token_here"
      }
    }
  }
}

Opencode / other MCP clients (recommended): If your MCP client does not reliably pass environment variables through npx, pass the token directly via CLI arguments:

{
  "mcpServers": {
    "tempus": {
      "command": ["npx", "-y", "tempus-mcp", "--token", "your_token_here", "--workspace-id", "12345678"]
    }
  }
}

Other MCP clients: The server uses stdio transport, compatible with any MCP client.

Environment Variables

Variable

Required

Description

TOGGL_API_TOKEN

✅

Your Toggl Track API token

TOGGL_DEFAULT_WORKSPACE_ID

❌

Default workspace ID for convenience

TOGGL_BASE_URL

❌

API base URL (default: https://api.track.toggl.com/api/v9)

Features

  • ✅ Past date time slots — Create time entries for any date in the past

  • ✅ Project assignment — Assign entries to any project

  • ✅ Full CRUD — Create, read, update, delete time entries

  • ✅ Billable tracking — Mark entries as billable

  • ✅ Tag support — Add tags to time entries

  • ✅ Running entries — Start, stop, and query current timer

Development

git clone https://github.com/Kos-M/tempus-mcp.git
cd tempus-mcp
npm install
npm run build
TOGGL_API_TOKEN=your_token npm start

License

MIT

Available Tools

12 tools
toggl_create_projectC

Create a new project in a workspace.

Inputs: workspace_id (required), name (required), client_id, is_private, +2 more.

toggl_create_time_entryA

Create a new time entry. Supports past dates - you can create time slots for any date in the past with an assigned project.

Inputs: workspace_id (required), start (required), description, project_id, +4 more.

toggl_delete_time_entryB

Delete a time entry permanently.

Inputs: workspace_id (required), time_entry_id (required).

toggl_get_current_time_entryA

Get the currently running time entry, if any.

Inputs: no named parameters.

toggl_get_meA

Get the authenticated user profile, including default workspace ID.

Inputs: no named parameters.

toggl_get_projectC

Get a single project by ID.

Inputs: workspace_id (required), project_id (required).

toggl_get_workspaceB

Get a single workspace by ID.

Inputs: workspace_id (required).

toggl_list_projectsB

List all projects in a workspace.

Inputs: workspace_id (required).

toggl_list_time_entriesC

List time entries with optional date filtering. Supports querying entries by date range.

Inputs: since, before, start_date, end_date.

toggl_list_workspacesA

List all workspaces accessible to the user.

Inputs: no named parameters.

toggl_stop_time_entryB

Stop a running time entry.

Inputs: workspace_id (required), time_entry_id (required).

toggl_update_time_entryB

Update an existing time entry. You can modify the description, project assignment, start/stop times, etc.

Inputs: workspace_id (required), time_entry_id (required), description, project_id, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool has a distinct purpose (create, delete, update, list, etc.) on specific resources (project, time entry, workspace, user). No two tools overlap in functionality; clear separation of concerns.

    Naming Consistency5/5

    All tools follow the consistent pattern 'toggl_verb_noun' with snake_case (e.g., toggl_create_project, toggl_list_time_entries). No mixed conventions or irregular naming.

    Tool Count5/5

    12 tools cover the core operations for project and time entry management (CRUD for time entries, basic project and workspace queries). This is a well-scoped set for a time tracking server.

    Completeness4/5

    Time entry operations are comprehensive (create, read, update, delete, stop). However, project update and delete are missing, and there is no explicit 'start time entry' tool (though create might start one). Minor gaps but core workflows are covered.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers