Tempus MCP
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 "Install 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 MCPCreate 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 |
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"
}
}
}
}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
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Kos-M/tempus-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server