activitywatch-mcp-server

Overview

The ActivityWatch MCP server connects to ActivityWatch, a time tracking application, and exposes its data and query capabilities to LLMs through the MCP protocol. It allows users to retrieve time tracking data, run queries using ActivityWatch's query language (AQL), access bucket information, and retrieve settings. The server is written in TypeScript and offers both npm installation and source building options, with detailed documentation for various use cases and environments.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list-buckets

  Lists all available ActivityWatch buckets with optional type filtering

  Try:What ActivityWatch buckets do I have?Try:Show me all window-type buckets
• run-query

  Run a query in ActivityWatch's query language (AQL)

  Try:Show me which applications I've used the most todayTry:Get browser activity from yesterday
• get-events

  Get raw events from an ActivityWatch bucket

  Try:Get events from my web bucket for the last hourTry:Retrieve the first 100 window events
• get-settings

  Get ActivityWatch settings from the server

  Try:What are my ActivityWatch settings?Try:Check the logging level setting

Comparable tools

Installation

npm install -g activitywatch-mcp-server

{
  "mcpServers": {
    "activitywatch": {
      "command": "activitywatch-mcp-server",
      "args": []
    }
  }
}

{
  "mcpServers": {
    "activitywatch": {
      "command": "node",
      "args": ["/path/to/activitywatch-mcp-server/dist/index.js"]
    }
  }
}

FAQ

What is the most common query format error?

The most frequent error is splitting query statements into separate array elements instead of combining them in one string. All statements should be in a single string within the query array.

How do I connect to ActivityWatch running on a different host?

Use the environment variable AW_API_BASE or the --aw-api-base flag: `export AW_API_BASE=http://mydesktop.local:5600/api/0`

Compare activitywatch-mcp-server with