list-buckets
Lists all available ActivityWatch buckets with optional type filtering.
How to use it
list-buckets is exposed by the Activitywatch MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the list-buckets 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
(optional): Name for the query (used for caching)
Array of query statements in ActivityWatch Query Language, where each
Run a query in ActivityWatch's query language (AQL).
(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")