home / mcp / wakapi mcp server

Wakapi MCP Server

MCP server for collecting logs from Wakapi (Unofficial)

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "impure0xntk-mcp-wakapi": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "git+https://github.com/impure0xntk/mcp-wakapi",
        "wakapi-mcp"
      ],
      "env": {
        "WAKAPI_URL": "http://localhost:3000",
        "WAKAPI_API_KEY": "your-api-key",
        "WAKAPI_API_PATH": "/compat/wakatime/v1"
      }
    }
  }
}

You can run a Wakapi MCP Server to collect development time logs from a Wakapi API and expose them as MCP tools that your clients can query. This enables fast, reproducible access to stats, projects, and heartbeats directly from your development environment.

How to use

You interact with the Wakapi MCP Server using an MCP client. The server provides tools to fetch user statistics, projects, leaders, and recent activity, all through simple tool calls. Authenticate with your Wakapi API key and point the server at your Wakapi instance. Start the server in STDIO mode for direct integration with MCP clients, or use an HTTP transport if you prefer a browser-friendly interface.

How to install

Prerequisites you need before installation:

- Python 3.11 or higher

- Wakapi server with API access

Quickstart configurations

{
  "mcpServers": {
    "wakapi": {
      "env": {
        "WAKAPI_URL": "http://localhost:3000",
        "WAKAPI_API_KEY": "your-api-key"
      },
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "git+https://github.com/impure0xntk/mcp-wakapi",
        "wakapi-mcp"
      ]
    }
  }
}

Enhanced security with a configuration file

{
  "mcpServers": {
    "wakapi": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "git+https://github.com/impure0xntk/mcp-wakapi",
        "wakapi-mcp",
        "--config",
        "/path/to/config.toml"
      ]
    }
  }
}

Configuration and environment details

Environment variables you configure to connect to Wakapi:

- WAKAPI_URL: URL of your Wakapi server (e.g., http://your-wakapi-server:3000)

- WAKAPI_API_KEY: Your Wakapi API key used for authentication

- WAKAPI_API_PATH: API path for Wakapi (default /compat/wakatime/v1)

What you can do with the tools

The Wakapi MCP Server exposes a set of tools to retrieve and inspect data from Wakapi. You can fetch statistics, projects, user details, leaderboards, and recent development logs, as well as verify the connection to the Wakapi server.

Available tools

Get Stats

Retrieve statistics for a given user over a specified time range via GET {api_path}/users/{user}/stats/{range}

Get Projects

Retrieve and filter the user projects via GET {api_path}/users/{user}/projects

Get User

Retrieve information about a specific user via GET {api_path}/users/{user}

Get Leaders

Retrieve leaderboard information via GET {api_path}/leaders

Get All Time Since Today

Retrieve all time information since today via GET {api_path}/users/{user}/all_time_since_today

Get Project Detail

Retrieve detailed information about a project via GET {api_path}/users/{user}/projects/{id}

Get Recent Logs

Retrieve recent development logs via GET {api_path}/users/{user}/heartbeats

Test Connection

Test the connection to the Wakapi server via a lightweight check