Reported issues for airflow-mcp-server
Pod holds 14 of 14 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.
Back to airflow-mcp-server.
Most discussed
Dynamic tool load via Categories can show tools
I'm using Claude 0.13.64 (7d2335) 2025-10-07T18:18:41.000Z
After initially showing me all the available tool categories, I asked to select Version. Here is my conversation, which never results in fetching the version number.
Me: select Version
I've selected the Version category. This category has 1 tool available.
The Version category tools are now active and ready to use. Would you like to see what specific tool is available in this category, or would you like to use it to check the
Read the thread · 2025-10-09 · closed · external user · 4 comments
Not working, getting error
raise KeyError(msg) KeyError: "Reference '#/$defs/ConnectionBody' not found."
Read the thread · 2025-10-04 · closed · external user · 3 comments
Project scope
Split the project into 2 different streams:
- Adding Airflow to AI (full access)
- Adding AI to Airflow (read-only access using Airflow Plugin)
Read the thread · 2025-02-15 · closed · 3 comments
Unable to load tools in http mode
The current configuration in mcp.json via VSCOde is as follows:
"airflow-mcp-server-http": {
"command": "uvx",
"args": [
"airflow-mcp-server",
"--http",
"--port",
"3000",
"--base-url",
"http://localhost:8080",
"--auth-token",
"JWT_TOKEN",
"--static-tools"
]
}
airflow-mcp-server --http --port 3000 --base-url http://loc
[Read the thread](https://github.com/abhishekbhakat/airflow-mcp-server/issues/31) · 2025-12-22 · open · external user · 2 comments
### Support both SSE and stdio
Currently it supports only stdio. There should also be an option to start an SSE server.
[Read the thread](https://github.com/abhishekbhakat/airflow-mcp-server/issues/23) · 2025-07-09 · closed · 1 comment
### Hierarchical Discovery of Tools
Airflow OpenAPI spec creates a lot of tools. We need a smart way to publish, a hierarchical way to discover tools.
For example:
If a user asks an operation of DAGs then only tools which are related to DAGS should be listed for LLM to operate on.
This can be achieved in a two-step process of LLM first categorizing the tools based on categories published in MCP server itself, then discovering tools for that specific category.
[Read the thread](https://github.com/abhishekbhakat/airflow-mcp-server/issues/21) · 2025-05-28 · closed · 1 comment
### Tools not loading in Claude Desktop
> [!WARNING]
> Claude Desktop is unable to load the tools due to smaller timeouts.
Timeouts are client-controlled:
- There is no server-side configuration or protocol message to set or override request timeouts.
- The client (e.g., Claude Desktop, MCP Inspector, or your own integration) is responsible for enforcing timeouts and cancelling requests if they take too long.
Below are the logs from Claude Desktop
```bash
2025-05-04T10:47:35.061Z [airflow-mcp-server] [info] Initializing server...
[Read the thread](https://github.com/abhishekbhakat/airflow-mcp-server/issues/20) · 2025-05-04 · closed · 1 comment
### Safe mode needs masking of secrets.
Airflow config has database connection URL and fernet key which holds secrets. Need a way to mask them when running in safe mode.
[Read the thread](https://github.com/abhishekbhakat/airflow-mcp-server/issues/16) · 2025-03-03 · open · 1 comment
## Most recent
### Create Airflow plugin to use safe mode of MCP server to have a chat interface
Relates to #3
[Read the thread](https://github.com/abhishekbhakat/airflow-mcp-server/issues/11) · 2025-02-23 · closed · 1 comment
### Remove Content-Type Header for Zero-Body Requests
DELETE pool operations fail with 400 Bad Request due to incorrectly including Content-Type header when no request body is needed. This violates RESTful principles and Airflow API expectations. The client needs modification to omit Content-Type headers for requests without bodies, ensuring compliance with HTTP specifications and Airflow's API requirements.
[Read the thread](https://github.com/abhishekbhakat/airflow-mcp-server/issues/8) · 2025-02-23 · closed · 0 comments
### Add a default YAML that points to latest stable Airflow Release of OpenAPI Spec
If user does not provides an OpenAPI Spec then it should default to latest Airflow Release of OpenAPI Spec which is embedded.
[Read the thread](https://github.com/abhishekbhakat/airflow-mcp-server/issues/5) · 2025-02-21 · closed · 0 comments
### test_connection tool no parameters parsed.
The tool fails to run as there are no parameters to provide
[Read the thread](https://github.com/abhishekbhakat/airflow-mcp-server/issues/4) · 2025-02-16 · closed · 0 comments
### List Tools needs better description
OpenAPI spec has better description which needs to be extracted and add to Tools objects.
Large models like claude 3.5 sonnet has no issues understanding but smaller models might benefit from it.
This will increase context usage a bit. Perhaps should made it optional.
[Read the thread](https://github.com/abhishekbhakat/airflow-mcp-server/issues/2) · 2025-02-14 · closed · 0 comments
### Add a safe mode for read-only operations
Airflow is used for sensitive projects as well. Needs a read-only mode.
[Read the thread](https://github.com/abhishekbhakat/airflow-mcp-server/issues/1) · 2025-02-14 · closed · 0 comments
The remaining reports are on [the project's issue tracker](https://github.com/abhishekbhakat/airflow-mcp-server/issues).