Сервер Model Context Protocol (MCP), который подключается к ActivityWatch позволяет LLM, таким как Клод Взаимодействуйте с данными отслеживания времени.

Особенности

• Список ведер: Смотреть все доступные ведра ActivityWatch Run Queries: выполнение мощных запросов AQL (ActivityWatch Query Language) Сырые события: Восстановление событий непосредственно из любого ведра Настройки доступа: настройки конфигурации Access ActivityWatch

##Установка

Установить MCP-сервер ActivityWatch можно либо с npm, либо самостоятельно.

###Установка с npm (скоро)

###Строительство из источника

1. Клонировать это хранилище:

2. Установить зависимости:

3.Создать проект:

Предпосылки

• Активность Часы установлены и работают Node.js (v14 или выше) Claude for Desktop (или любой другой клиент MCP)

Использование

Использование Claude для рабочего стола

1.Откройте Claude для файла конфигурации рабочего стола: Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

1. Добавить конфигурацию сервера MCP:

Если вы строите из источника, используйте:

1.Перезагрузить Клода для рабочего стола

ActivityWatch MCP Server

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

Features

• List Buckets: View all available ActivityWatch buckets
• Run Queries: Execute powerful AQL (ActivityWatch Query Language) queries
• Get Raw Events: Retrieve events directly from any bucket
• Get Settings: Access ActivityWatch configuration settings

Installation

You can install the ActivityWatch MCP server either from npm or by building it yourself.

Installing from npm (coming soon)

# Global installation
npm install -g activitywatch-mcp-server

# Or install locally
npm install activitywatch-mcp-server

Building from Source

1. Clone this repository:

   git clone https://github.com/8bitgentleman/activitywatch-mcp-server.git
   cd activitywatch-mcp-server
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Prerequisites

• ActivityWatch installed and running
• Node.js (v14 or higher)
• Claude for Desktop (or any other MCP client)

Usage

Using with Claude for Desktop

1. Open your Claude for Desktop configuration file:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the MCP server configuration:

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

   If you built from source, use:

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

3. Restart Claude for Desktop

4. Look for the MCP icon in Claude’s interface to confirm it’s working

Using a rootless podman container on Linux with Gemini CLI

Make sure to build the image first with:

version=$(npm pkg get version | tr -d '"')
podman build . -t activitywatch-mcp-server:${version}

This example uses the override for Activity Watch not being available on 127.0.0.1 (see next section). If not required, you may omit the AW_API_BASE environment variable.

{
  "mcpServers": {
    "activitywatch-mcp-server": {
      "command": "/usr/bin/podman",
      "args": [
        "run",
        "--rm",
        "--interactive",
        "--userns=keep-id",
        "-e",
        "AW_API_BASE",
        "localhost/activitywatch-mcp-server:1.2.1"
      ],
      "env": {
        "AW_API_BASE": "http://mydesktop.local:5600/api/0"
      }
    }
  }
}

Override ActivityWatch server host/port