Skip to main content
Glama
@mhdd_24/airflow-mcp

@mhdd_24/airflow-mcp

by Mhdd-24

@mhdd_24/airflow-mcp

MCP server for DAGs, runs, logs and task failures.

Same architecture as @mhdd_24/sublime-mcp.

Full documentation: docs/WIKI.md


How it works (30 seconds)

You (chat) → MCP client → airflow-mcp → Airflow APIs / CLIs / local tools

Related MCP server: Airflow MCP

Prerequisites

Requirement

Notes

Node.js 18+

ESM TypeScript MCP server

Credentials / CLIs

See environment variables below


Install

Option A — npm (after publish)

npm install -g @mhdd_24/airflow-mcp

Option B — npx

npx @mhdd_24/airflow-mcp

Option C — clone and build

git clone https://github.com/Mhdd-24/Airflow-MCP.git
cd Airflow-MCP
npm install
npm run build
node dist/index.js

Configure Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "airflow": {
      "command": "npx",
      "args": ["-y", "@mhdd_24/airflow-mcp"],
      "env": {
        "AIRFLOW_BASE_URL": "...",
        "AIRFLOW_USERNAME": "...",
        "AIRFLOW_PASSWORD": "..."
      }
    }
  }
}

Local development:

{
  "command": "node",
  "args": ["/absolute/path/to/Airflow-MCP/dist/index.js"]
}

Environment variables

Variable

Description

AIRFLOW_BASE_URL

Airflow URL

AIRFLOW_USERNAME

User

AIRFLOW_PASSWORD

Password


Tools

Tool

Description

airflow_status

Show dags configuration / health.

airflow_list

List dags resources/items.

airflow_get

Get a dags resource by id/name.

airflow_diagnose

Diagnostics / checklist for dags.


License

ISC

Available Tools

4 tools
airflow_diagnoseC

Diagnostics / checklist for dags.

Inputs: context.

airflow_getA

Get a dags resource by id/name.

Inputs: id (required).

airflow_listC

List dags resources/items.

Inputs: limit, query.

airflow_statusB

Show dags configuration / health.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 4 tools

    Disambiguation3/5

    Most tools are clearly distinct (list vs get vs status), but 'airflow_status' and 'airflow_diagnose' overlap in intent—both appear to inspect health or state, making it ambiguous which to choose for a given diagnostic question.

    Naming Consistency4/5

    All tools share the 'airflow_' prefix with snake_case, but 'airflow_status' uses a noun while the others use verbs (list, get, diagnose), creating a minor inconsistency in the naming pattern.

    Tool Count5/5

    Four tools is a tight, focused set for an Airflow-oriented server. Each tool addresses a distinct need and none feel redundant or superfluous.

    Completeness3/5

    The set covers read-only inspection and diagnostics well, but lacks common Airflow DAG operations like pause/unpause, trigger, or delete. If the intended scope is monitoring only, this is fine; for management tasks, there are notable gaps.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      Monitor and manage Apache Airflow clusters through natural language queries via MCP tools: DAG inspection, task monitoring, health checks, and cluster analytics without API complexity. * Guide: https://call518.medium.com/mcp-airflow-api-a-model-context-protocol-mcp-server-for-apache-airflow-5dfdfb2
      53
      54
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables users to interact with Apache Airflow orchestration platform through natural language to query pipeline statuses, troubleshoot DAG failures, trigger DAGs, and analyze configurations.
      11
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables natural language interaction with Apache Airflow for querying DAGs, monitoring execution, and troubleshooting failures.
      38 PyPI
      1
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Enables natural language management of Apache Airflow workflows, including DAG monitoring, task control, and configuration, via the Model Context Protocol.
      54
      MIT