activitywatch-mcp-server MCP Server

A Model Context Protocol (MCP) server that connects to ActivityWatch, allowing LLMs like Claude to interact with your time tracking data.

Local serverstdioMIT

What is the activitywatch-mcp-server MCP Server?

activitywatch-mcp-server is an MCP project maintained in the 8bitgentleman/activitywatch-mcp-server repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that connects to ActivityWatch, allowing LLMs like Claude to interact with your time tracking data”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using activitywatch-mcp-server. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
includeDataoptional): Include bucket data in response
timeperiodsTime period(s) to query formatted as array of strings. For date
queryArray of query statements in ActivityWatch Query Language, where each
bucketIdID of the bucket to fetch events from
startoptional): Start date/time in ISO format
endoptional): End date/time in ISO format
limitoptional): Maximum number of events to return
keyoptional): Get a specific settings key instead of all settings

How to install the activitywatch-mcp-server MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.