Back to Browse
Free
Server data from the Official MCP Registry
Airflow MCP — list DAGs/runs/task instances, tail logs, trigger and clear (write-gated)
About
Airflow MCP — list DAGs/runs/task instances, tail logs, trigger and clear (write-gated)
Security Report
10.0
Low Risk10.0Low RiskValid MCP server (3 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
12 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Airflow REST API base, e.g. 'http://airflow.example.com:8080/api/v1'.
Environment variable: AIRFLOW_API_URL
Airflow basic-auth username.
Environment variable: AIRFLOW_USERNAME
Airflow basic-auth password.Required
Environment variable: AIRFLOW_PASSWORD
Set to 'true' to enable trigger-dag and clear-task tools. Default read-only.
Environment variable: AIRFLOW_ALLOW_WRITE
Comma-separated category allowlist (airflow,meta).
Environment variable: AIRFLOW_TOOLS
Comma-separated category disablelist.
Environment variable: AIRFLOW_DISABLE
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-us-all-airflow": {
"env": {
"AIRFLOW_TOOLS": "your-airflow-tools-here",
"AIRFLOW_API_URL": "your-airflow-api-url-here",
"AIRFLOW_DISABLE": "your-airflow-disable-here",
"AIRFLOW_PASSWORD": "your-airflow-password-here",
"AIRFLOW_USERNAME": "your-airflow-username-here",
"AIRFLOW_ALLOW_WRITE": "your-airflow-allow-write-here"
},
"args": [
"-y",
"@us-all/airflow-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
@us-all/airflow-mcp
Airflow MCP server — read DAGs, runs, task instances, log tails; trigger and clear (write-gated). Built on
@us-all/mcp-toolkit.
A focused MCP for the Airflow Stable REST API. Read by default; airflow-trigger-dag and airflow-clear-task are gated behind AIRFLOW_ALLOW_WRITE=true.
For deeper dbt integration (manifest parsing, run-results history, source freshness, per-column test coverage, lineage walks, custom DQ result tables), install the companion @us-all/dbt-mcp alongside.
- 7 tools in
airflow+metacategories - 2 MCP Prompts for DAG triage workflows
- 1 aggregation tool that replaces the list-runs → get-task-instances combo
Install
pnpm add -D @us-all/airflow-mcp
Run
AIRFLOW_API_URL=http://airflow.example.com:8080/api/v1 \
AIRFLOW_USERNAME=admin AIRFLOW_PASSWORD=... \
npx @us-all/airflow-mcp
The server speaks MCP stdio; wire it into Claude Desktop / Cursor / any MCP client. Set MCP_TRANSPORT=http to opt in to Streamable HTTP transport (Bearer auth, /health endpoint).
Tools
airflow (6 + 1 aggregation)
| Tool | Description |
|---|---|
airflow-list-dags | List active DAGs with tag/search filters |
airflow-list-runs | Recent runs of one DAG (state filter, ordered newest first) |
airflow-get-task-instances | Task instances for a specific DAG run |
airflow-get-task-logs | Tail (last N kB) of one task instance log |
airflow-trigger-dag | Trigger a new run (write-gated) |
airflow-clear-task | Clear specific task instances → re-run (write-gated) |
dag-health-rollup | Aggregated DAG health: success rate + avg duration + last failed run + failing tasks |
meta
search-tools — natural-language tool discovery.
Prompts
| Prompt | Use when |
|---|---|
dag-failure-triage | "Why did DAG X fail?" — pulls runs, isolates failure, dumps logs, proposes remediation |
dag-schedule-audit | "Sweep all DAGs for low success rate and stuck runs" |
Environment variables
| Env | Required | Notes |
|---|---|---|
AIRFLOW_API_URL | yes | Airflow REST API base, e.g. http://airflow.example.com:8080/api/v1 |
AIRFLOW_USERNAME | no | Basic-auth username |
AIRFLOW_PASSWORD | no | Basic-auth password (secret) |
AIRFLOW_ALLOW_WRITE | no | true enables airflow-trigger-dag / airflow-clear-task |
AIRFLOW_TOOLS / AIRFLOW_DISABLE | no | Category toggles |
Tested-against schemas
- Airflow Stable REST API (2.x). Airflow 3.x exposes the same surface via the
/api/v1/Stable endpoints, so this server works with both 2.x and 3.x deployments.
Companion server
For dbt artifact parsing, run-results history, and DQ result tables, install @us-all/dbt-mcp alongside.
Build
pnpm install
pnpm run build # tsc → dist/
pnpm test # vitest
pnpm run smoke # spawns dist/index.js, calls initialize + tools/list (set env first)
License
MIT — see LICENSE.
Reviews
No reviews yet
Be the first to review this server!
More Data & Analytics MCP Servers
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
435
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
59
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
120.0K
Stars
17
Installs
6.0
Security
5.0
Local