airflow

Manage Apache Airflow DAGs, logs, and health via the Airflow MCP CLI.

419|61|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/astronomer/agents --skill airflow-astronomer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: airflow
Source: https://github.com/astronomer/agents/tree/main/skills/airflow
Command: npx skills add https://github.com/astronomer/agents --skill airflow-astronomer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Airflow operations can become complex when managing many DAGs, environments, and tasks. This skill centralizes control by exposing a consistent interface to list, test, run, and debug DAGs, view task logs, and monitor system health via the Airflow MCP server.

Core Features & Use Cases

  • DAG discovery and status checks
  • Run, test, and debug DAGs
  • View task logs, inspect connections and variables, and monitor system health
  • Use Case: Manage multiple Airflow deployments across prod and staging from a single client, with quick access to health and configurations.

Quick Start

Load the Airflow skill against your MCP server and start issuing commands, for example:

  • Check overall health: uvx --from astro-airflow-mcp af health
  • List DAGs: uvx --from astro-airflow-mcp af dags list
  • Run a DAG: uvx --from astro-airflow-mcp af runs trigger <dag_id>
  • View logs: uvx --from astro-airflow-mcp af tasks logs <dag_id> <task_id> <run_id>

Frequently Asked Questions about airflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list and trigger Airflow DAGs from the command line?

To trigger Airflow DAGs, use the astro-airflow-mcp package to run `af dags list` for discovery and `af runs trigger <dag_id>` to execute tasks across configured instances and environments.

How do I monitor Airflow health and check system status?

You can monitor Airflow health by running the `af health` command through the astro-airflow-mcp package, which checks overall system status and diagnoses issues across multiple deployment instances.

How do I view Airflow task logs to debug failed DAG runs?

To debug failed DAG runs, view Airflow task logs using the `af tasks logs <dag_id> <task_id> <run_id>` command to inspect execution details and diagnose failures within your environments.

Can I manage multiple Airflow deployments across staging and prod?

Yes, you can manage multiple Airflow deployments across staging and prod by using persistent instance configuration with the astro-airflow-mcp package to centrally control DAGs, connections, and variables.

How do I inspect Airflow connections and variables?

You can inspect Airflow connections and variables by using the astro-airflow-mcp CLI commands, which expose a consistent interface to view configurations and debug environment setups across instances.

What do I need to run and test Airflow DAGs using this approach?

You need uvx installed to run the astro-airflow-mcp package, which provides the `af` commands required to test, run, and debug Airflow DAGs and monitor system health.