A Model Context Protocol (MCP) 서버로 연결 ActivityWatch, Claude와 같은 LLM을 허용 시간 추적 데이터와 상호 작용합니다.

특징

-List 버킷: 모든 사용 가능한 ActivityWatch Buckets 보기

• Run Queries: 강력한 AQL 실행 (ActivityWatch Query Language) 쿼리
• ** 익지않는 사건을 얻으십시오 **: 어떤 물통에서 이벤트를 직접 검색 -Get Settings: Access ActivityWatch 설정

설치

npm 또는 직접 구축하여 ActivityWatch MCP 서버를 설치할 수 있습니다.

npm에서 설치 (곧 도착)

소스에서 건물

1. Clone 이 저장소:

2. 의존성 설치:

3. 프로젝트 구축:

필수품

• 활동 설치 및 실행
• Node.js (v14 이상)
• 데스크톱 용 Claude (또는 다른 MCP 클라이언트)

사용법

Desktop용 Claude 사용

1. 데스크탑 구성 파일에 대한 Claude를 엽니 다 :

• 윈도우: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

1. MCP 서버 구성 추가:

소스에서 내장 된 경우, 사용 :

1. 데스크탑을 위한 Restart Claude

2. 명세.

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