Waldur MCP server

Name: Waldur MCP server
Author: waldur

@waldur

Repository

About Waldur MCP server

Server implementing Model Context Protocol for Waldur

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "waldur-mcp-server": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "waldur-mcp-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Waldur MCP server?

Waldur MCP server enables integration between a Waldur instance and Claude Desktop by implementing the Model Context Protocol (MCP). It allows Claude to interact with your Waldur instance directly.

How to use Waldur MCP server?

Install Claude Desktop, Python 3.13+, and uv. Then install the package via pip install waldur-mcp-server or uv pip install waldur-mcp-server. Generate an API token from your Waldur instance (Username > Credentials > API Token). Configure Claude Desktop by editing claude_desktop_config.json with environment variables WALDUR_API_URL and WALDUR_TOKEN.

Key features of Waldur MCP server

Integrates Waldur instance with Claude Desktop
Implements the Model Context Protocol (MCP)
Allows direct Claude interaction with Waldur
Configuration via environment variables
Supports published and development server modes
Debuggable via MCP Inspector

Use cases of Waldur MCP server

—

FAQ from Waldur MCP server

How to install Waldur MCP server?

Install via pip (pip install waldur-mcp-server) or uv (uv pip install waldur-mcp-server).

How to generate a Waldur API token?

Log in to your Waldur instance, navigate to Username > Credentials > API Token, and generate a new token with an appropriate lifetime.

How to configure Claude Desktop for the server?

Edit claude_desktop_config.json (Windows: %APPDATA%\Claude\, MacOS: ~/Library/Application Support/Claude/) and add an entry under mcpServers with commands uvx waldur-mcp-server and environment variables WALDUR_API_URL and WALDUR_TOKEN.

How to debug the server?

Check log files at ~/Library/Logs/Claude/mcp.log on macOS. For advanced debugging, use the MCP Inspector with npx @modelcontextprotocol/inspector uv --directory <path> run waldur-mcp-server.