activitywatch-mcp-server
12
The ActivityWatch MCP Server is designed to integrate ActivityWatch time tracking data with LLMs such as Claude, allowing users to access and query their tracking data seamlessly. It supports a range of functionalities including listing buckets, running queries, retrieving raw events, and accessing configuration settings.
ActivityWatch MCP Server
A Model Context Protocol (MCP) server that connects to ActivityWatch, allowing LLMs like Claude to interact with your time tracking data.
Features
- List Buckets: View all available ActivityWatch buckets
- Run Queries: Execute powerful AQL (ActivityWatch Query Language) queries
- Get Raw Events: Retrieve events directly from any bucket
- Get Settings: Access ActivityWatch configuration settings
Prerequisites
- ActivityWatch installed and running
- Node.js (v14 or higher)
- Claude for Desktop (or any other MCP client)
Usage
- Add the MCP server configuration to your Claude for Desktop configuration file
- Restart Claude for Desktop to confirm it's working
Available Tools
- list-buckets: Lists all ActivityWatch buckets with optional type filtering
- run-query: Run a query using ActivityWatch's query language
- get-events: Get raw events from an ActivityWatch bucket
- get-settings: Retrieve ActivityWatch settings
Troubleshooting
Make sure ActivityWatch is running properly and check query syntax if issues arise.