airflow-mcp-server

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

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

Note:

• Set base_url to the root Airflow URL (e.g., http://localhost:8080).
• Do not include /api/v2 in the base URL. The server will automatically fetch the OpenAPI spec from ${base_url}/openapi.json.
• Only JWT token is required for authentication. Cookie and basic auth are no longer supported in Airflow 3.0.

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

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.

• 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)