How does authentication work?

For Airflow 3.x, it obtains and refreshes a JWT using the configured username and password. For Airflow 2.x, it falls back to HTTP basic authentication.

Can this server trigger DAG runs?

Yes. The trigger_dag_run tool starts a manual run for a specified DAG.

Which MCP client is shown in the documentation?

The README provides a configuration example for Claude Desktop.

MCP Airflow

airflowdata-platformsworkflow-orchestrationmonitoring

Manage Apache Airflow through its REST API, including DAGs, runs, task instances, triggers, and health checks.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "antonio-mello-ai-mcp-airflow": {
      "command": "uvx",
      "args": [
        "mcp-airflow"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

This MCP server exposes seven Apache Airflow REST API operations as tools. Use it to inspect DAG and task status, trigger manual runs, identify recent failures, and check scheduler and metadatabase health. It supports Airflow 3.x JWT authentication and Airflow 2.x basic authentication.

Use cases

List DAGs and their paused or active status

Inspect today’s DAG runs and task instances

Trigger manual DAG runs

Check failed DAGs from the last 24 hours

Monitor scheduler and metadatabase health

Key features

Lists DAGs with paused and active status

Retrieves DAG run and task instance details

Reports the latest status for a specific DAG

Triggers manual DAG runs

Checks recent failed DAGs

Checks scheduler heartbeat and metadatabase status

Capabilities & Tool Schemas (7)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Airflow.

list_dags

List all DAGs with paused/active status

get_dag_runs_today

Get all DAG runs from today with status

get_dag_run_status

Get the latest run status for a specific DAG

trigger_dag_run

Trigger a manual DAG run

get_task_instances

Get task instances for a specific DAG run

check_failed_dags

Check for failed DAGs in the last 24 hours

Documentation Overview

mcp-airflow

MCP server that exposes Apache Airflow REST API operations as tools. Built with FastMCP.

Install

bash

# Run directly with uvx (no install needed)
uvx mcp-airflow

# Or install with pip
pip install mcp-airflow

For development:

bash

uv pip install -e ".[dev]"
# or with dependency groups
uv sync --group dev

Configuration

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

Authentication

The client picks the auth scheme automatically based on your Airflow version:

Airflow 3.x (JWT) — a JWT token is obtained from the /auth/token endpoint using AIRFLOW_USERNAME/AIRFLOW_PASSWORD, sent as a Bearer token, and refreshed automatically. Point AIRFLOW_BASE_URL at /api/v2.
Airflow 2.x (basic auth) — if the JWT flow is unavailable, the client falls back to HTTP basic auth with the same username/password. Point AIRFLOW_BASE_URL at /api/v1.

Usage

Run the server:

bash

mcp-airflow

Or add to your MCP client config (e.g., Claude Desktop):

config.json

{
  "mcpServers": {
    "airflow": {
      "command": "mcp-airflow",
      "env": {
        "AIRFLOW_BASE_URL": "http://100.x.x.x:8080/api/v2",
        "AIRFLOW_USERNAME": "admin",
        "AIRFLOW_PASSWORD": "your-password"
      }
    }
  }
}

Tools

Tool	Description
`list_dags`	List all DAGs with paused/active status
`get_dag_runs_today`	Get all DAG runs from today with status
`get_dag_run_status`	Get the latest run status for a specific DAG
`trigger_dag_run`	Trigger a manual DAG run
`get_task_instances`	Get task instances for a specific DAG run
`check_failed_dags`	Check for failed DAGs in the last 24 hours
`check_scheduler_health`	Check scheduler heartbeat and metadatabase status

Tests

bash

pytest

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Data Platforms View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

3mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Airflow

The server supports Airflow 3.x through the /api/v2 endpoint and Airflow 2.x through the /api/v1 endpoint.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/antonio-mello-ai-mcp-airflow?style=directory)](https://allmcps.com/mcp/antonio-mello-ai-mcp-airflow)

HTML Embed

<a href="https://allmcps.com/mcp/antonio-mello-ai-mcp-airflow"><img src="https://allmcps.com/api/badge/antonio-mello-ai-mcp-airflow?style=directory" alt="MCP Airflow on AllMCPs" /></a>

Technical Specs & Signals

CategoryData Platforms

PricingFree

53Quality signal: Good · 53/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity2/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · mcp-airflow (PyPI)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 📊 Data Platforms →Best MCP servers for Data Platforms →Alternatives to MCP Airflow →Install in Claude Desktop Install in Cursor Install in VS Code

MCP Airflow

airflowdata-platformsworkflow-orchestrationmonitoring

Manage Apache Airflow through its REST API, including DAGs, runs, task instances, triggers, and health checks.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "antonio-mello-ai-mcp-airflow": {
      "command": "uvx",
      "args": [
        "mcp-airflow"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

List DAGs and their paused or active status

Inspect today’s DAG runs and task instances

Trigger manual DAG runs

Check failed DAGs from the last 24 hours

Monitor scheduler and metadatabase health

Key features

Lists DAGs with paused and active status

Retrieves DAG run and task instance details

Reports the latest status for a specific DAG

Triggers manual DAG runs

Checks recent failed DAGs

Checks scheduler heartbeat and metadatabase status

Capabilities & Tool Schemas (7)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Airflow.

list_dags

List all DAGs with paused/active status

get_dag_runs_today

Get all DAG runs from today with status

get_dag_run_status

Get the latest run status for a specific DAG

trigger_dag_run

Trigger a manual DAG run

get_task_instances

Get task instances for a specific DAG run

check_failed_dags

Check for failed DAGs in the last 24 hours

Documentation Overview

mcp-airflow

MCP server that exposes Apache Airflow REST API operations as tools. Built with FastMCP.

Install

bash

# Run directly with uvx (no install needed)
uvx mcp-airflow

# Or install with pip
pip install mcp-airflow

For development:

bash

uv pip install -e ".[dev]"
# or with dependency groups
uv sync --group dev

Configuration

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

Authentication

The client picks the auth scheme automatically based on your Airflow version:

Airflow 3.x (JWT) — a JWT token is obtained from the /auth/token endpoint using AIRFLOW_USERNAME/AIRFLOW_PASSWORD, sent as a Bearer token, and refreshed automatically. Point AIRFLOW_BASE_URL at /api/v2.
Airflow 2.x (basic auth) — if the JWT flow is unavailable, the client falls back to HTTP basic auth with the same username/password. Point AIRFLOW_BASE_URL at /api/v1.

Usage

Run the server:

bash

mcp-airflow

Or add to your MCP client config (e.g., Claude Desktop):

config.json

{
  "mcpServers": {
    "airflow": {
      "command": "mcp-airflow",
      "env": {
        "AIRFLOW_BASE_URL": "http://100.x.x.x:8080/api/v2",
        "AIRFLOW_USERNAME": "admin",
        "AIRFLOW_PASSWORD": "your-password"
      }
    }
  }
}

Tools

Tool	Description
`list_dags`	List all DAGs with paused/active status
`get_dag_runs_today`	Get all DAG runs from today with status
`get_dag_run_status`	Get the latest run status for a specific DAG
`trigger_dag_run`	Trigger a manual DAG run
`get_task_instances`	Get task instances for a specific DAG run
`check_failed_dags`	Check for failed DAGs in the last 24 hours
`check_scheduler_health`	Check scheduler heartbeat and metadatabase status

Tests

bash

pytest

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Data Platforms View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

3mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Airflow

The server supports Airflow 3.x through the /api/v2 endpoint and Airflow 2.x through the /api/v1 endpoint.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/antonio-mello-ai-mcp-airflow?style=directory)](https://allmcps.com/mcp/antonio-mello-ai-mcp-airflow)

HTML Embed

<a href="https://allmcps.com/mcp/antonio-mello-ai-mcp-airflow"><img src="https://allmcps.com/api/badge/antonio-mello-ai-mcp-airflow?style=directory" alt="MCP Airflow on AllMCPs" /></a>

Technical Specs & Signals

CategoryData Platforms

PricingFree

53Quality signal: Good · 53/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity2/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · mcp-airflow (PyPI)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 📊 Data Platforms →Best MCP servers for Data Platforms →Alternatives to MCP Airflow →Install in Claude Desktop Install in Cursor Install in VS Code