airflow-mcp-server: An MCP Server for controlling Airflow

@MCP-Mirror

About airflow-mcp-server: An MCP Server for controlling Airflow

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "airflow-mcp-server": {
      "command": "uvx",
      "args": [
        "airflow-mcp-server",
        "--base-url",
        "http://localhost:8080",
        "--auth-token",
        "<jwt_token>"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is airflow-mcp-server?

An MCP (Model Context Protocol) server that controls Apache Airflow by interacting with Airflow’s REST APIs. It automatically parses the Airflow OpenAPI specification and supports both read-only and full‑access modes.

How to use airflow-mcp-server?

Install and run the server via uvx with the airflow-mcp-server CLI, providing the Airflow base URL and a JWT token. Optionally set --safe for read‑only operations or --unsafe (default) for all operations. Configure the server in your MCP client (e.g., Claude Desktop) using the mcpServers block.

Key features of airflow-mcp-server

Supports Airflow 3.0 and its JWT authentication.
Safe mode restricts operations to GET requests only.
Automatically fetches OpenAPI spec from the Airflow base URL.
Reads Airflow configuration to respect the page limit setting.
Exposes all Airflow API endpoints as MCP tools with proper descriptions.

Use cases of airflow-mcp-server

List and inspect DAGs, tasks, and their statuses without modifying anything.
Trigger DAG runs, clear task instances, or pause/unpause DAGs (in unsafe mode).
Monitor Airflow health and configuration from an AI‑assistant interface.
Safely explore an Airflow instance’s API surface through language model tools.

FAQ from airflow-mcp-server

What authentication does airflow-mcp-server require?

Only JWT token authentication is supported. Provide the token via the --auth-token parameter or the AUTH_TOKEN environment variable. Cookie and basic auth are not supported in Airflow 3.0.

What is the difference between safe and unsafe mode?

Safe mode allows only read‑only (GET) operations, preventing any modifications to your Airflow instance. Unsafe mode permits all operations, including creates, updates, and deletes.

How should I specify the base URL?

Set --base-url to the root Airflow URL (e.g., http://localhost:8080). Do not include /api/v2; the server automatically fetches the OpenAPI spec from ${base_url}/openapi.json.

Can I change the maximum number of items returned?

Yes. The default page limit is 100 items. You can change it by setting maximum_page_limit in the [api] section of your airflow.cfg file.

Is Airflow 3.0 supported?

Yes. The server is designed for Airflow 3.0 readiness and works exclusively with its JWT‑based authentication.

Frequently asked questions

What authentication does airflow-mcp-server require?

Only JWT token authentication is supported. Provide the token via the `--auth-token` parameter or the `AUTH_TOKEN` environment variable. Cookie and basic auth are not supported in Airflow 3.0.

What is the difference between safe and unsafe mode?

Safe mode allows only read‑only (GET) operations, preventing any modifications to your Airflow instance. Unsafe mode permits all operations, including creates, updates, and deletes.

How should I specify the base URL?

Set `--base-url` to the root Airflow URL (e.g., `http://localhost:8080`). Do **not** include `/api/v2`; the server automatically fetches the OpenAPI spec from `${base_url}/openapi.json`.

Can I change the maximum number of items returned?

Yes. The default page limit is 100 items. You can change it by setting `maximum_page_limit` in the `[api]` section of your `airflow.cfg` file.

Is Airflow 3.0 supported?

Yes. The server is designed for Airflow 3.0 readiness and works exclusively with its JWT‑based authentication.

Comments

Basic information

More Data & Analytics MCP servers

BidSkim - UK Tenders & Contract Renewals

BidSkim

UK procurement intelligence for AI assistants: search live UK government tenders, find contract renewals with expiry dates and incumbent suppliers, and profile public-sector buyers and suppliers. Covers Find a Tender, Co

AskRentAI

Ask your Rent Manager property portfolio anything, from the AI you already use. AskRentAI is a hosted, read-only MCP server for Rent Manager, the property management platform used across a large share of US rental housi

Stratyfix

Stratyfix is an AI-driven sales intelligence platform. This connector lets managers and reps ask about their own Stratyfix data in the chat they already use. Are we going to make the quarter? Who needs my attention this

LeadMarina

Verified local-business leads: search any niche in any city, query your lead library, and export to Close, GoHighLevel, Google Sheets, or emailed files — every email SMTP-checked, every phone verified with line type and

Waqi - AI Privacy Layer

ajprolific

Waqi — hosted MCP server that redacts PII from your business tools before the AI sees them. Audit log included.