run-query
Run a query in ActivityWatch's query language (AQL).
How to use it
run-query is exposed by the Activitywatch MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the 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
npm install -g activitywatch-mcp-serverOther tools in Activitywatch MCP Server (13)
ID of the bucket to fetch events from
(optional): End date/time in ISO format
Get raw events from an ActivityWatch bucket.
Get ActivityWatch settings from the server.
(optional): Include bucket data in response
(optional): Get a specific settings key instead of all settings
(optional): Maximum number of events to return
Lists all available ActivityWatch buckets with optional type filtering.
(optional): Name for the query (used for caching)
Array of query statements in ActivityWatch Query Language, where each
(optional): Start date/time in ISO format
Time period(s) to query formatted as array of strings. For date
(optional): Filter buckets by type (e.g., "window", "web", "afk")