MCP server for Toggl Track integration with intelligent caching and reporting tools
{
"mcpServers": {
"mcp-toggl": {
"command": "<see-readme>",
"args": []
}
}
}No install config available. Check the server's README for setup instructions.
Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
MCP server for Toggl Track integration with intelligent caching and reporting tools
Is it safe?
No package registry to scan.
No authentication — any process on your machine can connect.
License not specified.
Is it maintained?
Last commit 90 days ago. 10 stars.
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
No automated test available for this server. Check the GitHub README for setup instructions.
No known vulnerabilities.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationHave you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Dynamic problem-solving through sequential thought chains
A Model Context Protocol server for searching and analyzing arXiv papers
An open-source AI agent that brings the power of Gemini directly into your terminal.
The official Python SDK for Model Context Protocol servers and clients
MCP Security Weekly
Get CVE alerts and security updates for Mcp Toggl and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
A Model Context Protocol (MCP) server for Toggl Track integration, providing time tracking and reporting capabilities with intelligent caching for optimal performance.
Use via npx without cloning or building locally.
Add this to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"mcp-toggl": {
"command": "npx @verygoodplugins/mcp-toggl@latest",
"env": {
"TOGGL_API_KEY": "your_api_key_here",
"TOGGL_DEFAULT_WORKSPACE_ID": "123456",
"TOGGL_CACHE_TTL": "3600000",
"TOGGL_CACHE_SIZE": "1000"
}
}
}
}
Add this to your Cursor MCP settings (e.g., ~/.cursor/mcp.json):
{
"mcp": {
"servers": {
"mcp-toggl": {
"command": "npx",
"args": ["@verygoodplugins/mcp-toggl@latest"],
"env": {
"TOGGL_API_KEY": "your_api_key_here",
"TOGGL_DEFAULT_WORKSPACE_ID": "123456",
"TOGGL_CACHE_TTL": "3600000",
"TOGGL_CACHE_SIZE": "1000"
}
}
}
}
}
npm install
npm run build
Get your Toggl API key from: https://track.toggl.com/profile
Create a .env file:
TOGGL_API_KEY=your_api_key_here
# Aliases also supported (use one of these only if needed):
# TOGGL_API_TOKEN=your_api_key_here
# TOGGL_TOKEN=your_api_key_here
# Optional configuration
TOGGL_DEFAULT_WORKSPACE_ID=123456 # Your default workspace
TOGGL_CACHE_TTL=3600000 # Cache TTL in ms (default: 1 hour)
TOGGL_CACHE_SIZE=1000 # Max cached entities (default: 1000)
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"mcp-toggl": {
"command": "node",
"args": ["/path/to/mcp-toggl/dist/index.js"],
"env": {
"TOGGL_API_KEY": "your_api_key_here"
}
}
}
}
Edit .mcp.json in your project:
{
"mcpServers": {
"mcp-toggl": {
"command": "node",
"args": ["./mcp-servers/mcp-toggl/dist/index.js"],
"env": {
"TOGGL_API_KEY": "your_api_key_here"
}
}
}
}
toggl_get_time_entriesGet time entries with optional filters.
{
"period": "today", // or: yesterday, week, lastWeek, month, lastMonth
"workspace_id": 123456,
"project_id": 789012
}
toggl_get_current_entryGet the currently running timer.
toggl_start_timerStart a new time entry.
{
"description": "Working on MCP server",
"project_id": 123456,
"tags": ["development", "mcp"]
}
toggl_stop_timerStop the currently running timer.
toggl_daily_reportGenerate a daily report with project/workspace breakdowns.
{
"date": "2024-09-01",
"format": "json" // or "text" for formatted output
}
toggl_weekly_reportGenerate a weekly report with daily breakdowns.
{
"week_offset": 0, // 0 = this week, -1 = last week
"format": "json"
}
toggl_project_summaryGet total hours per project for a date range.
{
"period": "month",
"workspace_id": 123456
}
toggl_workspace_summaryGet total hours per workspace.
toggl_list_workspacesList all available workspaces.
toggl_list_projectsList pro