Atlas / MCP servers / kestra-io / Kestra Python Server

Kestra Python ServerSAFE

mcp/kestra-io/kestra-python-server

Python MCP Server for Kestra — you can use it as a tool in Kestra's AI Agents

Verdict
SAFE
Grade
B
Trust score
89 /100
Exposed tools
5 3r · 1w · 1d
Transport
stdio
License
Apache-2.0
Stars
33
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

Kestra Python MCP Server

You can run the MCP Server in a Docker container. This is useful if you want to avoid managing Python environments or dependencies on your local machine.

Using Kestra AI Agent

See kestramcpdocker.

Minimal configuration for OSS users

Paste the following configuration into your MCP settings (e.g., Cursor, Claude, or VS Code):

{
"mcpServers": {
"kestra": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--pull",
"always",
"-e",
"KESTRA_BASE_URL",
"-e",
"KESTRA_TENANT_ID",
"-e",
"KESTRA_MCP_DISABLED_TOOLS",
"-e",
"KESTRA_MCP_LOG_LEVEL",
"-e",
"KESTRA_USERNAME",
"-e",
"KESTRA_PASSWORD",
"ghcr.io/kestra-io/mcp-server-python:latest"
],
"env": {
"KESTRA_BASE_URL": "http://host.docker.internal:8080/api/v1",
"KESTRA_TENANT_ID": "main",
"KESTRA_MCP_DISABLED_TOOLS": "ee",
"KESTRA_MCP_LOG_LEVEL": "ERROR",
"KESTRA_USERNAME": "[email protected]",
"KESTRA_PASSWORD": "your_password"
}
}
}
}

Minimal configuration for EE users

{
"mcpServers": {
"kestra": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--pull",
"always",
"-e", "KESTRA_BASE_URL",
"-e", "KESTRA_API_TOKEN",
"-e", "KESTRA_TENANT_ID",
"-e", "KESTRA_MCP_LOG_LEVEL",
"ghcr.io/kestra-io/mcp-server-python:latest"
],
"env": {
"KESTRA_BASE_URL": "http://host.docker.internal:8080/api/v1",
"KESTRA_API_TOKEN": "",
"KESTRA_TENANT_ID": "main",
"KESTRA_MCP_LOG_LEVEL": "ERROR"
}
}
}
}

Detailed Configuration using Docker

{
"mcpServers": {
"kestra": {
"command": "docker",
"args": [
Read from source at commit 572ec477a23dOBSERVED · 2026-10-08
02

Exposed tools (5)

3 read · 1 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.

ToolRiskDescription
create_flow_from_yamlwriteCreate or update a Kestra flow from a raw YAML definition. Returns the created or updated flow
force_run_executiondestructiveForce run an execution only if it is in CREATED, PAUSED, or QUEUED state.
get_instance_inforeadGet instance metadata: configuration (default) or license info.
list_flows_in_namespacereadRetrieve all flows in a given namespace.
list_namespace_dependenciesreadRetrieve all flow-to-flow dependencies within a given namespace and render them as an ASCII dependency graph **using only the flow IDs**. Always return the legend after the graph.
03

Trust audit

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codePASS
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfaceWARN
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (1 observation(s))
Network
declared (5 observation(s))
Shell
none-observed
Dependencies
not all pinned
Secrets in source
none-found

Findings (4)

MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59
force_run_execution
Why it matters. 1 tool(s) can delete or overwrite
Fix. prefer a read-only mode or scoped tokens; the page states the blast radius
LOWInventory / provenance · inv.hidden_file · CWE-1104
.env_example
.env_example
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWNetwork egress · net.env_exfil · CWE-200, CWE-319
tests/test_ee.py:12
".env" ... httpx.
Why it matters. reads secrets in the same file that sends data out
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
requirements.txt
fastmcp
Why it matters. 1 requirement(s) not pinned with ==
Fix. pin exact versions

Gates applied: no_behavioural_pass.

Audited 2026-10-08 · audit v0.4.1 · source sha 572ec477a23dfull audit observations/trust-audit/mcp-server/kestra-io__kestra-python-server.json · Report an issue / request a re-scan
04

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-08572ec477a23dSAFEB89first audit
05

Questions

What is the Kestra Python Server MCP server?

Python MCP Server for Kestra — you can use it as a tool in Kestra's AI Agents

What tools does Kestra Python Server expose?

5 in total: 3 read-only, 1 that write, and 1 that can delete or overwrite (force_run_execution). Every one is listed on this page with its risk.

Is Kestra Python Server safe to connect to an agent?

The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.

What credentials does Kestra Python Server need?

It reads KESTRA_API_TOKEN and KESTRA_PASSWORD from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How does Kestra Python Server run?

It speaks stdio, so it runs as a local process your client starts.

How current is this page?

The grade is for one exact copy of the source (572ec477a23d), read on 2026-10-08. The repository is watched and re-audited when it changes.

Advertisement