title: MCP Airflow kind: source_doc area: engineering project: mcp-airflow collection: mcp-airflow owner: maintainers status: current canonical: README.md globalRef: qmd://mcp-airflow/README.md reviewCadenceDays: 90 lastReviewedAt: 2026-09-28 sourceRefs:
- pyproject.toml related:
- AGENTS.md
- docs/fluxos-negocio.md
- docs/arquitetura.md
- docs/operacao.md
- docs/index.md supersedes: [] supersededBy: [] sensitivity: public
mcp-airflow
MCP server that exposes Apache Airflow REST API operations as tools. Built with the FastMCP API from the MCP Python SDK.
This is an open-source package. The maintainers do not operate a public hosted Airflow endpoint through this repository.
Install
# Run directly with uvx (no install needed)
uvx mcp-airflow
# Or install with pip
pip install mcp-airflowFor development:
uv pip install -e ".[dev]"
# or with dependency groups
uv sync --group devConfiguration
Set these environment variables (or create a .env file from .env.example):
| Variable | Description | Example |
|---|---|---|
AIRFLOW_BASE_URL |
Airflow REST API base URL. Use /api/v2 for Airflow 3.x or /api/v1 for 2.x |
http://100.x.x.x:8080/api/v2 |
AIRFLOW_USERNAME |
Auth username (JWT on 3.x, basic auth on 2.x) | admin |
AIRFLOW_PASSWORD |
Auth password |
