Leantime MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with access to Leantime’s (leantime.io) JsonRPC 2.0 API. This enables AI tools like Claude to interact with Leantime projects, tickets, timesheets, users, and more through a standardized interface.

This server uses FastMCP which supports multiple transport protocols including stdio, HTTP, WebSocket, and SSE, making it suitable for various deployment scenarios.

The leantime mcp plugin is not needed. If you own the leantime mcp plugin consider using https://github.com/Leantime/php-mcp-server instead.

MCP Client Configuration

This project uses uv for fast, reliable Python package management. Ensure it is installed before modifying your MCP settings.

To use with Claude Desktop or other MCP clients, add to your MCP settings:

STDIO Transport (Default)

For local MCP clients like Claude Desktop that communicate via standard input/output:

{
  "mcpServers": {
    "leantime": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/daniel-eder/leantime-mcp.git",
        "leantime-mcp"
      ],
      "env": {
        "LEANTIME_URL": "https://your-leantime-instance.com",
        "LEANTIME_API_KEY": "your_api_key_here",
        "LEANTIME_USER_EMAIL": "[email protected]"
      }
    }
  }
}

HTTP Transport

For remote HTTP connections, first start the server with HTTP transport (see Running the Server), then configure your MCP client to connect to the HTTP endpoint:

{
  "mcpServers": {
    "leantime-http": {
      "url": "http://localhost:8000/mcp",
      "transport": "streamableHttp"
    }
  }
}

Note: The HTTP transport configuration depends on your MCP client’s support for HTTP connections. The server must be running separately using the fastmcp run command with --transport http option. Make sure to set the required environment variables (LEANTIME_URL, LEANTIME_API_KEY, LEANTIME_USER_EMAIL) when starting the HTTP server.

Getting a Leantime API Key

1. Log in to your Leantime instance
2. Go to Company -> API Keys
3. Generate a new API key

Running the Server

This server supports multiple transport protocols for different deployment scenarios:

STDIO Transport (Default)

For use with MCP clients like Claude Desktop that communicate via standard input/output:

# Using the entry point
leantime-mcp

# Or run directly
python -m src.leantime_mcp.server

HTTP Transport

For remote access via HTTP, useful for web services and remote clients:

# Run on default port 8000
fastmcp run src/leantime_mcp/server.py:app --transport http

# Run on custom port
fastmcp run src/leantime_mcp/server.py:app --transport http --port 9000