# Kestra MCP server

> Lets AI clients manage Kestra workflows, executions, namespaces, files, and KV data through tool calls.

- Repository: https://github.com/kestra-io/mcp-server-python
- Page: https://hostedmcp.org/servers/kestra-io/mcp-server-python
- Transport: —
- Stars: 35
- License: Apache-2.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `KESTRA_API_TOKEN` | no | no |  |
| `KESTRA_API_VERSION` | no | no |  |
| `KESTRA_BASE_URL` | no | no |  |
| `KESTRA_MCP_DISABLED_TOOLS` | no | no |  |
| `KESTRA_MCP_LOG_LEVEL` | no | no |  |
| `KESTRA_PASSWORD` | no | no |  |
| `KESTRA_TENANT_ID` | no | no |  |
| `KESTRA_USERNAME` | no | no |  |

## FAQ

### How do I connect the Kestra MCP server to Cursor or Claude?

Add a kestra entry to your MCP settings that runs the Docker image ghcr.io/kestra-io/mcp-server-python with the KESTRA_BASE_URL and tenant environment variables.

### How do I authenticate the Kestra MCP server for OSS installs?

For OSS installations use KESTRA_USERNAME and KESTRA_PASSWORD basic authentication instead of an API token.

### How do I disable Enterprise Edition tools in OSS?

Set the KESTRA_MCP_DISABLED_TOOLS environment variable to ee; you can list multiple tool groups separated by commas.

### Which Kestra versions does the MCP server support?

The same image supports both Kestra 1.x and 2.x, detecting the major version automatically from the API configs endpoint or via KESTRA_API_VERSION.

### Can I change the server's log verbosity?

Yes, set KESTRA_MCP_LOG_LEVEL to ERROR (default), WARNING, INFO, or DEBUG.