bucket_id
ID of the bucket to fetch events from
How to use it
bucket_id 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 bucket_id 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).
(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")