activitywatch-run-query
Run a query in ActivityWatch's query language (AQL).
How to use it
activitywatch-run-query is exposed by the Activitywatch MCP Server Py MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the activitywatch-run-query tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Activitywatch MCP Server Py
uvx activitywatch-mcp-server-pyOther tools in Activitywatch MCP Server Py (14)
Get raw events from an ActivityWatch bucket.
Get ActivityWatch settings from the server.
Lists all available ActivityWatch buckets with optional type filtering.
Get examples of properly formatted queries for the ActivityWatch MCP server. This tool takes no parameters and returns helpful examples.
ID of the bucket to fetch events from
(optional): End date/time in ISO format
(optional): Include bucket data in response
(optional): Get a specific settings key instead of all settings
(optional): Maximum number of events to return
(optional): Name for the query (used for caching)
Array of query statements in ActivityWatch Query Language, where each item is a complete query with statements separated by semicolons
(optional): Start date/time in ISO format
Time period(s) to query formatted as array of strings. For date ranges, use format: ["2024-10-28/2024-10-29"]
(optional): Filter buckets by type (e.g., "window", "web", "afk")