What can you do with this server?

Query and analyze Wakapi development-time tracking data through an MCP server. * Retrieve coding statistics for a user over specified time ranges, filtered by project, language, editor, OS, machine, or label. * List and filter a user's projects. * Retrieve user profile information. * View leaderboard rankings. * Get all-time coding summary since today. * Retrieve detailed information for a specific project. * Fetch recent development logs/heartbeats across recent days, optionally filtered by project and limited in count. * Test connectivity to the Wakapi server.

Which integrations are available for this server?

Provides development time tracking tools by collecting logs from Wakapi REST API, including statistics, project details, leaderboards, and recent development activity logs

How do I use Wakapi MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Wakapi MCP Server show me my coding stats from last week" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Wakapi MCP Server

by impure0xntk

Overview Schema Source Related Servers Discussions Admin

Python

Remote

Wakapi MCP Server

This is an MCP (Model Context Protocol) server. It provides development time tracking tools by collecting logs from Wakapi REST API.

This repository is unofficial. Use at your own risk.

Quick Start

Prerequisites

Python 3.11 or higher
Wakapi server with API access

MCP Server Configuration Examples

Quickstart with Environment Variables

{
  "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 Configuration File

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

Related MCP server: WakaTime MCP Server

Features

Collects development time logs via the Wakapi API
Provides MCP tools for retrieving development data
Fast processing using FastMCP
Reproducible development environment with Nix flakes
Modular tool architecture
Improved testability through dependency injection
Design based on the single responsibility principle

Provided Tools

This server provides the following tools that can be used by MCP-compatible clients: Note: {api_path} is configurable: by default, /compat/wakatime/v1. Please see the Configuration section.

Tool Name	Description	API Endpoint
Get Stats	Retrieve statistics for a given user over a specified time range	GET {api_path}/users/{user}/stats/{range}
Get Projects	Retrieve and filter the user projects	GET {api_path}/users/{user}/projects
Get User	Retrieve the given user information	GET {api_path}/users/{user}
Get Leaders	Retrieve leaderboard information	GET {api_path}/leaders
Get All Time Since Today	Retrieve all time information since today	GET {api_path}/users/{user}/all_time_since_today
Get Project Detail	Retrieve detailed information about a specific project	GET {api_path}/users/{user}/projects/{id}
Get Recent Logs	Retrieve recent development logs	GET {api_path}/users/{user}/heartbeats
Test Connection	Test connection to the Wakapi server	None

Configuration Details

Environment Variables Configuration

The most common way to configure the server is through environment variables:

export WAKAPI_URL="http://your-wakapi-server:3000"
export WAKAPI_API_KEY="your_actual_api_key_here"
export WAKAPI_API_PATH="/compat/wakatime/v1"

Or pass to mcpServers:

{
  "mcpServers": {
    "wakapi": {
      "env": {
        "WAKAPI_URL": "http://localhost:3000",
        "WAKAPI_API_KEY": "your-api-key"
      },
      ...

Configuration Files

You can also use configuration files in TOML or JSON format:

TOML format (config.toml):

[wakapi]
url = "http://your-wakapi-server:3000"
api_key = "your_actual_api_key_here"
api_path = "/compat/wakatime/v1"
timeout = 30
retry_count = 3

[server]
host = "0.0.0.0"
port = 8000

[logging]
level = "INFO"
format = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"

JSON format (config.json):

{
  "wakapi": {
    "url": "http://your-wakapi-server:3000",
    "api_key": "your_actual_api_key_here",
    "api_path": "/compat/wakatime/v1",
    "timeout": 30,
    "retry_count": 3
  },
  "server": {
    "host": "0.0.0.0",
    "port": 8000
  },
  "logging": {
    "level": "INFO",
    "format": "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
  }
}

For Developers

Setup Development Environment

This project provides a reproducible development environment using Nix flakes:

# Start the development environment
nix develop

# Or start a shell
nix-shell

And also use uv to activate, sync and run.

nix build for the packaged server does not currently succeed: MCP 2026-07-28 needs fastmcp 4.x on the mcp 2.x SDK, and no available nixpkgs carries it. Use uv sync until nixpkgs ships fastmcp 4.

Starting the MCP Server from python command

# Set environment variables
export WAKAPI_URL="http://localhost:3000"
export WAKAPI_API_KEY="your_actual_api_key_here"
export WAKAPI_API_PATH="/compat/wakatime/v1"

# Start the server in STDIO mode (default)
python main.py --transport stdio

# Start the server in Streamable HTTP mode
python main.py --transport http

# Start with a configuration file
python main.py --config /path/to/config.toml

Authentication Method: The API key is automatically base64-encoded and sent as a Bearer token.

--transport stdio: Uses STDIO transport (default). Can be used directly with MCP clients like opencode
--transport http: Uses Streamable HTTP transport. The endpoint is http://<host>:<port>/mcp, with host and port taken from the [server] section of the config file

Streamable HTTP

MCP revision 2026-07-28 replaced the standalone SSE endpoint with a single Streamable HTTP endpoint. One route at /mcp carries initialize, tools/list and tools/call, including server-initiated SSE streams, so --transport sse no longer exists.

Add --stateless-http to run without server-side session state, which suits serverless or horizontally scaled deployments that cannot keep sessions warm:

python main.py --transport http --stateless-http

Testing

You can test the server using pytest:

# Run all tests
pytest

# Run specific tests
pytest tests/test_mcp_server.py -v

License

Apache License 2.0

Contributing

Issues and Pull Requests are welcome.

Available Tools

8 tools

get_all_time_since_todayGet All Time Since TodayC

Retrieve summary for all time since today for the specified user.

operationId: get-all-time summary: Retrieve summary for all time description: Mimics https://wakatime.com/developers#all_time_since_today tags: [wakatime] parameters:

name: user in: path description: User ID to fetch data for (or 'current') required: true schema: type: string responses: 200: description: OK schema: v1.AllTimeViewModel