MCP Integration
Waqt exposes an MCP server so AI assistants can run structured time-tracking operations via tools.
Start the MCP server
waqt-mcp
# or, in source setups:
uv run waqt-mcp
Example client configuration (Claude Desktop)
{
"mcpServers": {
"waqt": {
"command": "uv",
"args": ["run", "waqt-mcp"],
"env": {}
}
}
}
Available MCP tools
| Tool | Purpose |
|---|---|
start, end, add_entry, edit_entry | Core session and entry lifecycle. |
summary, list_entries | Retrieve weekly/monthly stats and entry lists. |
leave_request | Create vacation/sick leave ranges. |
export_entries, import_entries | Move data in/out for processing and backup. |
list_config, get_config, set_config | Inspect and mutate app configuration. |
create_template_tool, list_templates_tool, apply_template_tool, delete_template_tool | Template management from MCP clients. |
Operational recommendations
- Run with explicit date/time values to reduce ambiguity in automations.
- Prefer
summary+list_entriesbefore destructive actions. - For large migrations, use export/import tools and validate with summaries.