@mhdd_24/airflow-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@mhdd_24/airflow-mcp why did my etl_pipeline DAG fail yesterday?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@mhdd_24/airflow-mcp
MCP server for DAGs, runs, logs and task failures.
Same architecture as @mhdd_24/sublime-mcp.
Full documentation: docs/WIKI.md
How it works (30 seconds)
You (chat) → MCP client → airflow-mcp → Airflow APIs / CLIs / local toolsRelated MCP server: Airflow MCP
Prerequisites
Requirement | Notes |
Node.js 18+ | ESM TypeScript MCP server |
Credentials / CLIs | See environment variables below |
Install
Option A — npm (after publish)
npm install -g @mhdd_24/airflow-mcpOption B — npx
npx @mhdd_24/airflow-mcpOption C — clone and build
git clone https://github.com/Mhdd-24/Airflow-MCP.git
cd Airflow-MCP
npm install
npm run build
node dist/index.jsConfigure Cursor
Edit ~/.cursor/mcp.json:
{
"mcpServers": {
"airflow": {
"command": "npx",
"args": ["-y", "@mhdd_24/airflow-mcp"],
"env": {
"AIRFLOW_BASE_URL": "...",
"AIRFLOW_USERNAME": "...",
"AIRFLOW_PASSWORD": "..."
}
}
}
}Local development:
{
"command": "node",
"args": ["/absolute/path/to/Airflow-MCP/dist/index.js"]
}Environment variables
Variable | Description |
| Airflow URL |
| User |
| Password |
Tools
Tool | Description |
| Show dags configuration / health. |
| List dags resources/items. |
| Get a dags resource by id/name. |
| Diagnostics / checklist for dags. |
License
ISC
Available Tools
4 toolsairflow_diagnoseC
Diagnostics / checklist for dags.
Inputs: context.
airflow_getA
Get a dags resource by id/name.
Inputs: id (required).
airflow_listC
List dags resources/items.
Inputs: limit, query.
airflow_statusB
Show dags configuration / health.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Most tools are clearly distinct (list vs get vs status), but 'airflow_status' and 'airflow_diagnose' overlap in intent—both appear to inspect health or state, making it ambiguous which to choose for a given diagnostic question.
All tools share the 'airflow_' prefix with snake_case, but 'airflow_status' uses a noun while the others use verbs (list, get, diagnose), creating a minor inconsistency in the naming pattern.
Four tools is a tight, focused set for an Airflow-oriented server. Each tool addresses a distinct need and none feel redundant or superfluous.
The set covers read-only inspection and diagnostics well, but lacks common Airflow DAG operations like pause/unpause, trigger, or delete. If the intended scope is monitoring only, this is fine; for management tasks, there are notable gaps.
Maintenance
Related MCP Connectors
Query your org's data in natural language — read-only MCP access to SQL, NoSQL, files & warehouses.
Query your warehouse or a CSV with Claude/ChatGPT over MCP, governed by table-level ACL + audit.
MCP observability. Query live traffic, errors, duration, and alerts from your AI agent.
MCP-Native LLM Orchestration Agent
Related MCP Servers
- AlicenseCqualityBmaintenanceMonitor and manage Apache Airflow clusters through natural language queries via MCP tools: DAG inspection, task monitoring, health checks, and cluster analytics without API complexity. * Guide: https://call518.medium.com/mcp-airflow-api-a-model-context-protocol-mcp-server-for-apache-airflow-5dfdfb25354MIT
- AlicenseNot gradedqualityDmaintenanceEnables users to interact with Apache Airflow orchestration platform through natural language to query pipeline statuses, troubleshoot DAG failures, trigger DAGs, and analyze configurations.11MIT
- AlicenseNot gradedqualityCmaintenanceEnables natural language interaction with Apache Airflow for querying DAGs, monitoring execution, and troubleshooting failures.38 PyPI1MIT
- AlicenseCqualityDmaintenanceEnables natural language management of Apache Airflow workflows, including DAG monitoring, task control, and configuration, via the Model Context Protocol.54MIT