query
Array of query statements in ActivityWatch Query Language, where each item is a complete query with statements separated by semicolons
How to use it
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 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.
Run a query in ActivityWatch's query language (AQL).
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)
(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")