drio
Open app

ActivityWatch MCP Server

Source

Model Context Protocol server for ActivityWatch time tracking data

Catalog onlyCatalog onlySTDIO

Overview

ActivityWatch MCP Server is a Model Context Protocol server that connects to ActivityWatch, enabling LLMs like Claude to interact with your time tracking data.

To use the server, install it via npm or build it from source, then configure it with your Claude for Desktop application to start querying your ActivityWatch data.

  • List all available ActivityWatch buckets - Execute powerful AQL (ActivityWatch Query Language) queries - Retrieve raw events from any bucket - Access ActivityWatch configuration settings
  1. Querying application usage statistics
  2. Analyzing productivity trends over time
  3. Integrating time tracking data with AI models for insights

Add to your AI client

Use these steps to connect ActivityWatch MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "activitywatch-mcp-server-8bitgentleman": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-activitywatch-mcp-server-8bitgentleman"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "activitywatch-mcp-server-8bitgentleman": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-activitywatch-mcp-server-8bitgentleman"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "activitywatch-mcp-server-8bitgentleman": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-activitywatch-mcp-server-8bitgentleman"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "activitywatch-mcp-server-8bitgentleman": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-activitywatch-mcp-server-8bitgentleman"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "activitywatch-mcp-server-8bitgentleman": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-activitywatch-mcp-server-8bitgentleman"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "activitywatch-mcp-server-8bitgentleman": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-activitywatch-mcp-server-8bitgentleman"
      ]
    }
  }
}

FAQ

**What is required to run the server?**

You need ActivityWatch installed and running, Node.js (v14 or higher), and a compatible MCP client like Claude for Desktop.

**How do I install the server?**

You can install it globally via npm or build it from the source code available on GitHub.

**What kind of queries can I run?**

You can run queries to list buckets, get application usage summaries, view browsing history, and check productivity metrics.

Research and data