Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TOGGL_API_KEY | Yes | Your Toggl API key (get from https://track.toggl.com/profile) | |
| TOGGL_CACHE_TTL | No | Cache TTL in milliseconds (default: 1 hour) | 3600000 |
| TOGGL_CACHE_SIZE | No | Maximum number of cached entities (default: 1000) | 1000 |
| TOGGL_DEFAULT_WORKSPACE_ID | No | Your default workspace ID |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| toggl_check_auth | Verify Toggl API connectivity and authentication is valid |
| toggl_get_time_entries | Get time entries with optional date range filters. Returns hydrated entries with project/workspace names. |
| toggl_get_current_entry | Get the currently running time entry, if any |
| toggl_start_timer | Start a new time entry timer |
| toggl_stop_timer | Stop the currently running timer |
| toggl_daily_report | Generate a daily report with hours by project and workspace |
| toggl_weekly_report | Generate a weekly report with daily breakdown and project summaries |
| toggl_project_summary | Get total hours per project for a date range |
| toggl_workspace_summary | Get total hours per workspace for a date range |
| toggl_list_workspaces | List all available workspaces |
| toggl_list_projects | List projects for a workspace |
| toggl_list_clients | List clients for a workspace |
| toggl_warm_cache | Pre-fetch and cache workspace, project, and client data for better performance |
| toggl_cache_stats | Get cache statistics and performance metrics |
| toggl_clear_cache | Clear all cached data |