Tempus MCP
Tempus MCP is a Model Context Protocol server that gives AI assistants full access to your Toggl Track time tracking data through natural language.
Time Entry Management:
List time entries with optional filtering by date range or modification time
Get the currently running time entry and stop an active timer
Create time entries for any date (past or future) with project assignment, tags, billable status, and custom start/stop times
Update existing time entries (description, project, times, duration, tags, billable status)
Delete time entries permanently
Project Management:
List all projects in a workspace
Get details of a specific project by ID
Create new projects with options for name, color, billable default, client association, and privacy settings
Workspace & User Info:
List all accessible workspaces and get details for a specific workspace
Retrieve the authenticated user's profile (including default workspace ID)
List all clients within a workspace
Provides tools for interacting with Toggl Track, enabling AI agents to manage time entries (create, read, update, delete, stop, get current), projects (list, get, create), workspaces, clients, and user profile through the Toggl Track API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Tempus MCP Create a time entry for yesterday 2-4pm on Design project."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| List time entries with optional date filtering |
| Get the currently running time entry |
| Create time entries for any date (past or future) with project assignment, tags, and billable status |
| Update existing time entries (description, project, start/stop, duration) |
| Permanently delete a time entry |
| Stop a running time entry |
Projects
Tool | Description |
| List all projects in a workspace |
| Get a single project by ID |
| Create a new project |
Workspaces & User
Tool | Description |
| List all accessible workspaces |
| Get workspace details |
| Get authenticated user profile |
| List clients in a workspace |
Related MCP server: Toggl MCP Server
Installation
npm install -g tempus-mcp
# or
npx tempus-mcpUsage
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-mcp3. 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 |
| ✅ | Your Toggl Track API token |
| ❌ | Default workspace ID for convenience |
| ❌ | API base URL (default: |
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 startLicense
MIT
Available Tools
12 toolstoggl_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
Scored across 12 tools
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.
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.
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.
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
Related MCP Connectors
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Read your tracked time and projects, pause tracking or add a note, from Claude or ChatGPT.
Time tracking you talk to: log, check and fix your work hours from your AI assistant.
Track time in Clockify: time entries, projects, clients, tags and reports; start, stop and log time.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Clockify time tracking API to manage time entries, projects, tasks, and workspaces through natural language commands.33 npm5ISC
- AlicenseAqualityDmaintenanceEnables control of Toggl time tracking directly from LLMs like Claude or ChatGPT. Supports starting/stopping timers, viewing current and historical time entries, managing projects, and generating weekly summaries through natural language.811 npm3MIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to the TrackingTime API v4 for managing projects, tasks, and team assignments. Users can start or stop timers, log manual time entries, and organize project workflows using natural language.16 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with the Toggl time tracking API to manage time entries, projects, and workspaces through natural language.22MIT