Model Context Protocol server wrapper over Apache Airflow REST API. Enables MCP clients to interact with Airflow in a standardized way for managing DAGs, runs, tasks, and much more.

Installation

UVX

uvx mcp-server-apache-airflow

Configuration

Claude Desktop — Basic Auth

{
  "mcpServers": {
    "mcp-server-apache-airflow": {
      "command": "uvx",
      "args": ["mcp-server-apache-airflow"],
      "env": {
        "AIRFLOW_HOST": "https://your-airflow-host",
        "AIRFLOW_USERNAME": "your-username",
        "AIRFLOW_PASSWORD": "your-password"
      }
    }
  }
}

Claude Desktop — JWT Token

{
  "mcpServers": {
    "mcp-server-apache-airflow": {
      "command": "uvx",
      "args": ["mcp-server-apache-airflow"],
      "env": {
        "AIRFLOW_HOST": "https://your-airflow-host",
        "AIRFLOW_JWT_TOKEN": "your-jwt-token"
      }
    }
  }
}

Features

• DAG Management — list, details, pause/resume, update, delete DAGs
• DAG Runs — create, list, update, delete, and clear DAG runs
• Task Management — list tasks, get task instances, view logs, clear and update task states
• Variables — create, read, update, delete Airflow variables
• Connections — manage Airflow connections and test connectivity
• Pools — manage resource pools
• XComs — access cross-communication data between tasks
• Datasets — manage datasets and dataset events
• Monitoring — health checks and system statistics
• Configuration — access Airflow configuration and plugins

Environment Variables

Optional

• AIRFLOW_HOST — URL of the Airflow host
• AIRFLOW_API_VERSION — API version
• READ_ONLY — enable read-only mode for security
• AIRFLOW_USERNAME — username for basic authentication
• AIRFLOW_PASSWORD — password for basic authentication
• AIRFLOW_JWT_TOKEN — JWT token for authentication (takes precedence over basic auth)

Notes

Uses the official Apache Airflow client library for compatibility. Supports basic authentication and JWT token authentication. JWT token takes precedence if both are specified. Read-only mode is recommended for security.