Kestra Python ServerSAFE
Python MCP Server for Kestra — you can use it as a tool in Kestra's AI Agents
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": [
572ec477a23dOBSERVED · 2026-10-08Exposed 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.
| Tool | Risk | Description |
|---|---|---|
create_flow_from_yaml | write | Create or update a Kestra flow from a raw YAML definition. Returns the created or updated flow |
force_run_execution | destructive | Force run an execution only if it is in CREATED, PAUSED, or QUEUED state. |
get_instance_info | read | Get instance metadata: configuration (default) or license info. |
list_flows_in_namespace | read | Retrieve all flows in a given namespace. |
list_namespace_dependencies | read | Retrieve 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. |
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.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (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)
force_run_execution
.env_example
".env" ... httpx.
fastmcp
Gates applied: no_behavioural_pass.
572ec477a23dfull audit observations/trust-audit/mcp-server/kestra-io__kestra-python-server.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 572ec477a23d | SAFE | B | 89 | first audit |
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.