ActivityWatch MCP Server
by 8bitgentleman
The ActivityWatch MCP Server connects to ActivityWatch, enabling LLMs like Claude to interact with your time tracking data. It allows you to query and retrieve information about your activity data using natural language.
Last updated: N/A
What is ActivityWatch MCP Server?
The ActivityWatch MCP Server is a Model Context Protocol server that acts as a bridge between ActivityWatch and Large Language Models (LLMs) like Claude. It allows you to use natural language to query and interact with your ActivityWatch data, providing insights into your time usage and productivity.
How to use ActivityWatch MCP Server?
- Install the server from npm or build from source. 2. Configure Claude for Desktop to connect to the server by adding the server configuration to the Claude configuration file. 3. Restart Claude and use natural language queries to interact with your ActivityWatch data.
Key features of ActivityWatch MCP Server
List Buckets
Run Queries (AQL)
Get Raw Events
Get Settings
Use cases of ActivityWatch MCP Server
Analyzing application usage
Tracking website browsing history
Monitoring productivity
Retrieving specific ActivityWatch settings
FAQ from ActivityWatch MCP Server
How do I install the ActivityWatch MCP Server?
How do I install the ActivityWatch MCP Server?
You can install it from npm (coming soon) or build it from source using the provided instructions.
What are the prerequisites for using this server?
What are the prerequisites for using this server?
You need ActivityWatch installed and running, Node.js (v14 or higher), and an MCP client like Claude for Desktop.
How do I configure Claude for Desktop to use this server?
How do I configure Claude for Desktop to use this server?
Add the MCP server configuration to your Claude for Desktop configuration file (claude_desktop_config.json).
What kind of queries can I run?
What kind of queries can I run?
You can list buckets, run AQL queries, get raw events, and get ActivityWatch settings. Refer to the example queries for guidance.
What do I do if I encounter query errors?
What do I do if I encounter query errors?
Check your query syntax, bucket IDs, timeperiods, and ActivityWatch logs. Pay close attention to the required JSON format for queries, especially when prompting Claude.