bucketId
ID of the bucket to fetch events from
How to use it
bucketId is exposed by the Activitywatch MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the bucketId 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)
(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
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")