← Explore all mcp servers

WORKFLOW ORCHESTRATION / Kestra

Kestra MCP Server

Inspect and operate Kestra workflows, executions, namespace files and KV data through the publisher Python adapter.

“Kestra Python MCP Server”

01 / THE REASONING

Why this made the selection.

  • Documents OSS versus Enterprise authentication and tool-group selection.
  • Handles differences in Kestra 1.x and 2.x request formats explicitly.
  • The pinned README runs a Kestra MCP server in Docker against a Kestra API, with separate OSS and Enterprise credential examples.
  • Enterprise-only tools can be disabled, and dashboard creation on OSS 2.x does not silently succeed.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • README.md
  • LICENSE at the pinned revision
  • src/server.py
  • requirements.txt
  • LICENSE
  • Round 2 reread of acquired publisher setup and permission evidence; see immutable wave review.

Our findings

  • src/server.py gives BasicAuth precedence when both username/password are present, otherwise uses the bearer token.
  • Disabled groups are omitted at registration; the entrypoint explicitly starts stdio.
  • The Docker image talks to a Kestra API. OSS examples use a username and password; Enterprise examples use KESTRA_API_TOKEN.
  • The ee tool group is Enterprise-only. On OSS, KESTRA_MCP_DISABLED_TOOLS=ee turns those tools off, and generate_dashboard cannot create a dashboard through the API on OSS 2.x.
  • With stdio, the IDE launches the process. The README does not claim the container can reach the host on Linux without host networking or a bridge.
  • The client applies the configured tenant to its API path and X-Kestra-Tenant header, so tenant configuration affects the destination of every operation.

Not established by this review

  • Server startup, authentication, live tool execution and security isolation were not tested.
  • Published package/container parity with a source revision and hosted implementation internals were not tested.
  • The server was not started and its tools were not called.
  • A pin does not verify transitive dependencies.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Connect a server deliberately.

Upstream setup instructions ↗

DOCUMENTED COMMAND

docker run -i --rm -e KESTRA_BASE_URL -e KESTRA_TENANT_ID -e KESTRA_API_TOKEN -e KESTRA_MCP_DISABLED_TOOLS ghcr.io/kestra-io/mcp-server-python:latest

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. Set KESTRA_BASE_URL to the reachable API /api/v1 path and KESTRA_TENANT_ID if needed.
  2. For EE/Cloud supply KESTRA_API_TOKEN. For OSS use the documented KESTRA_USERNAME/KESTRA_PASSWORD Docker environment flags and disable ee.
  3. Disable unneeded groups with KESTRA_MCP_DISABLED_TOOLS; inspect execution and flow permissions on the Kestra identity before enabling changes.
  4. Set KESTRA_TENANT_ID for the intended EE/Cloud tenant and list disabled tool groups explicitly as comma-separated names before launching stdio.

Before you start

  • Docker and a stdio MCP client, plus a reachable Kestra API.
  • Edition-appropriate credentials; source development instead requires Python 3.13 and requirements.txt.

Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

{
  "mcpServers": {
    "kestra": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KESTRA_BASE_URL",
        "-e",
        "KESTRA_TENANT_ID",
        "-e",
        "KESTRA_API_TOKEN",
        "-e",
        "KESTRA_MCP_DISABLED_TOOLS",
        "ghcr.io/kestra-io/mcp-server-python:latest"
      ]
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/kestra-io/mcp-server-python/blob/a15806feeb8a8828e92ac4f23739fa4a14a37414/README.md

    Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports

  2. https://github.com/kestra-io/mcp-server-python/blob/a15806feeb8a8828e92ac4f23739fa4a14a37414/src/server.py

    Supports: review, install, access, limitations

  3. https://github.com/kestra-io/mcp-server-python/blob/a15806feeb8a8828e92ac4f23739fa4a14a37414/requirements.txt

    Supports: review, install, access, limitations

  4. Applicable licence text ↗Checked

    https://github.com/kestra-io/mcp-server-python/blob/a15806feeb8a8828e92ac4f23739fa4a14a37414/LICENSE

    Supports: license

Evidence & Ask