What are the prerequisites to use this server?
ActivityWatch must be installed and running, Node.js v14 or higher is required, and an MCP‑compatible client (e.g., Claude for Desktop) is needed.
ActivityWatch MCP Server
@8bitgentleman
Basic information
About ActivityWatch MCP Server
Model Context Protocol server for ActivityWatch time tracking data
ActivityWatch MCP Server config
No standard config provided
This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.
RepositoryActivityWatch MCP Server tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is ActivityWatch MCP Server?
A Model Context Protocol server that connects to ActivityWatch, allowing LLMs like Claude to interact with your time tracking data.
How to use ActivityWatch MCP Server?
Install via npm or build from source. Configure the server in your MCP client (e.g., Claude for Desktop) by adding it to the client’s config file. ActivityWatch must be running on http://localhost:5600.
Key features of ActivityWatch MCP Server?
- List all ActivityWatch buckets
- Run AQL queries against time data
- Get raw events from any bucket
- Access ActivityWatch configuration settings
Use cases of ActivityWatch MCP Server?
- Get a summary of which applications you used most today
- View your browsing history by time spent per website
- Check how much time you spent in productivity apps
- Retrieve current ActivityWatch settings or a specific setting
- Debug your ActivityWatch data by fetching raw bucket events
Frequently asked questions
Why does the server show connection errors?
If ActivityWatch is not running or is not accessible at `http://localhost:5600`, the server will report connection errors. Ensure ActivityWatch is started and reachable.
How do I fix query errors when using the MCP server?
Check your AQL syntax, verify bucket IDs are correct, confirm the timeperiods contain data, and review ActivityWatch logs for details. Common formatting issues include splitting query statements into separate array elements instead of one string.
What is the correct format for queries?
All query statements must be in a single string inside the `query` array. Example: `["events = query_bucket('bucket_id'); RETURN = events;"]`. `timeperiods` should be an array of date‑range strings like `["2024-10-28/2024-10-29"]`.
How does the server connect to ActivityWatch?
The server connects to the ActivityWatch API at `http://localhost:5600` by default. If your ActivityWatch instance uses a different host or port, modify the source code.
More Other MCP servers
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
39.5K
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
23.2K
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
22.0K
Klarix Intelligence Engine
KlarixB2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.
Senso MCP for Joomla
sensomediaSenso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea
Comments