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

Find on Glama

Overview

A Model Context Protocol server for controlling Airflow via Airflow APIs.

Demo Video

https://github.com/user-attachments/assets/f3e60fff-8680-4dd9-b08e-fa7db655a705

Setup

Usage with Claude Desktop

{
  "mcpServers": {
    "airflow-mcp-server": {
      "command": "uvx",
      "args": [
        "airflow-mcp-server"
      ],
      "env": {
        "AIRFLOW_BASE_URL": "http://<host:port>",
        "AUTH_TOKEN": "<jwt_access_token>"
      }
    }
  }
}

Note:

Set AIRFLOW_BASE_URL to the root Airflow URL (e.g., http://localhost:8080).

Do not include /api/v1 in the base URL. The server will automatically fetch the OpenAPI spec from ${AIRFLOW_BASE_URL}/openapi.json.

Only AUTH_TOKEN (JWT) is required for authentication. Cookie and basic auth are no longer supported in Airflow 3.0.

Operation Modes

The server supports two operation modes:

Safe Mode (--safe): Only allows read-only operations (GET requests). This is useful when you want to prevent any modifications to your Airflow instance.
Unsafe Mode (--unsafe): Allows all operations including modifications. This is the default mode.

To start in safe mode:

airflow-mcp-server --safe

To explicitly start in unsafe mode (though this is default):

airflow-mcp-server --unsafe

Considerations

The MCP Server expects environment variables to be set:

AIRFLOW_BASE_URL: The root URL of the Airflow instance (e.g., http://localhost:8080)
AUTH_TOKEN: The JWT access token for authentication

Authentication

Only JWT authentication is supported in Airflow 3.0. You must provide a valid AUTH_TOKEN.

Page Limit

The default is 100 items, but you can change it using maximum_page_limit option in [api] section in the airflow.cfg file.

Tasks

Airflow 3 readiness
Parse OpenAPI Spec
Safe/Unsafe mode implementation
Parse proper description with list_tools.
Airflow config fetch (specifically for page limit)
Env variables optional (env variables might not be ideal for airflow plugins)

2.3 KiB Raw Blame History