home / mcp / leantime mcp server

Leantime MCP Server

MCP server enabling Leantime data access for MCP clients with endpoints for projects, tickets, time tracking, sprints, and goals.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "damonhess-mcp-leantime": {
      "url": "http://mcp-leantime:8000/mcp",
      "headers": {
        "LOG_LEVEL": "INFO",
        "LEANTIME_URL": "http://leantime:8080",
        "LEANTIME_API_KEY": "lt_user_key"
      }
    }
  }
}

This MCP server enables Leantime data to flow into your n8n workflows, exposing projects, tickets, time tracking, sprints, and goals as MCP endpoints. You can list projects, manage tickets, log time, and query timesheets directly from your automation pipelines, unlocking streamlined project management automation.

How to use

Connect your MCP client to the Leantime MCP Server using the provided HTTP endpoint. You will interact with a stable set of endpoints to list projects, fetch project users, create and update tickets, log time, punch timers, and retrieve timesheets, sprints, and goals. Use your MCP client’s credentials to authenticate and perform actions in your workflows without needing to hard-code API calls in every step.

How to install

Prerequisites you need on your machine or server before installing the MCP server:

- Docker or a container runtime to build and run the MCP server image.

Installation steps you should follow precisely:

docker build -t mcp-leantime .
docker run -p 8000:8000 -e LEANTIME_URL=http://leantime:8080 -e LEANTIME_API_KEY=lt_user_key mcp-leantime

Available tools

list_projects

Retrieve all accessible projects from Leantime via MCP and expose them to your workflows.

get_project_users

Fetch users assigned to a specific Leantime project for user-aware automation.

create_ticket

Create a new ticket or task in Leantime from your MCP client.

get_ticket

Retrieve detailed information for a specific ticket.

update_ticket

Update fields on an existing ticket such as title, description, or assignees.

update_ticket_status

Change the status of a ticket to reflect progress or completion.

log_time

Log time against a ticket, enabling accurate time tracking in workflows.

punch_in

Start a timer for a ticket to capture work duration.

punch_out

Stop the active timer for a ticket and finalize the time entry.

get_timesheets

Query timesheet entries for reporting and automation.

get_sprints

Retrieve all sprints for a given project for agile planning automation.

get_goals

Fetch goals to integrate progress tracking into workflows.