# Airflow MCP Server

> Airflow MCP Server is an open-source MCP server for developer tools. MCP server that lets AI clients inspect and control Apache Airflow 3 via its API. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/abhishekbhakat/airflow-mcp-server
- **MCP Registry name:** io.github.abhishekbhakat/airflow-mcp-server
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The server wraps the Airflow REST API so an AI client can work with DAGs, tasks and connections in an Airflow 3 deployment. Setup needs only a base URL for the Airflow instance and a JWT token, since the server loads the API spec from the instance itself rather than requiring a separate configuration file.

A safe mode restricts it to read-only GET requests, which suits monitoring or troubleshooting sessions where nothing should change. Unsafe mode, the default, exposes write operations as well. By default tools are grouped into hierarchical categories, and a static option exposes everything at once. A resources directory can publish local Markdown guides to the client.

The README is aimed at data engineers and platform teams who run Airflow and want an assistant to query pipeline state or make controlled changes. It supports stdio and Streamable HTTP transports.

## Features

- **Read-only safe mode:** A flag restricts the server to GET requests so the assistant cannot modify the Airflow instance.
- **Hierarchical tool discovery:** Tools are grouped into categories such as DAGs, Tasks and Connections, with an option to expose them all statically.
- **JWT authentication:** Connects to Airflow 3 using a JWT token, the only authentication method the README says is supported.
- **Markdown resources:** Points at a folder of Markdown files and exposes each top-level file as a read-only resource.
- **Multiple transports:** Runs over stdio by default or Streamable HTTP for shared, networked deployments.

## Good for

- Checking the status of DAG runs and failed tasks from an AI chat client
- Reviewing Airflow connections and configuration during troubleshooting
- Triggering or pausing DAGs with a read-only guard in place
- Giving an assistant local runbooks as reference resources

## Install

### Claude Code (Terminal)

```sh
claude mcp add airflow-mcp-server --env AIRFLOW_BASE_URL='<AIRFLOW_BASE_URL>' --env AUTH_TOKEN='<AUTH_TOKEN>' -- uvx airflow-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "airflow-mcp-server": {
      "command": "uvx",
      "args": [
        "airflow-mcp-server"
      ],
      "env": {
        "AIRFLOW_BASE_URL": "<AIRFLOW_BASE_URL>",
        "AUTH_TOKEN": "<AUTH_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "airflow-mcp-server": {
      "command": "uvx",
      "args": [
        "airflow-mcp-server"
      ],
      "env": {
        "AIRFLOW_BASE_URL": "<AIRFLOW_BASE_URL>",
        "AUTH_TOKEN": "<AUTH_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "airflow-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "airflow-mcp-server"
      ],
      "env": {
        "AIRFLOW_BASE_URL": "<AIRFLOW_BASE_URL>",
        "AUTH_TOKEN": "<AUTH_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "airflow-mcp-server": {
      "command": "uvx",
      "args": [
        "airflow-mcp-server"
      ],
      "env": {
        "AIRFLOW_BASE_URL": "<AIRFLOW_BASE_URL>",
        "AUTH_TOKEN": "<AUTH_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "airflow-mcp-server": {
      "command": "uvx",
      "args": [
        "airflow-mcp-server"
      ],
      "env": {
        "AIRFLOW_BASE_URL": "<AIRFLOW_BASE_URL>",
        "AUTH_TOKEN": "<AUTH_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Which Airflow version does it support?

The README describes it as a server for controlling Airflow 3 and states that only JWT authentication is supported in Airflow 3.0.

### Can it run without write access?

Yes. Starting it with the --safe flag limits it to read-only GET operations.

### Do I need to include /api/v2 in the base URL?

No. The README says to use the root Airflow URL, and the server fetches the OpenAPI spec from that base.

### Is Airflow MCP Server free?

Yes. Airflow MCP Server is open source, so you can use and self-host it for free.

### How do I add Airflow MCP Server to Claude Code?

Run this command in your terminal: claude mcp add airflow-mcp-server --env AIRFLOW_BASE_URL='<AIRFLOW_BASE_URL>' --env AUTH_TOKEN='<AUTH_TOKEN>' -- uvx airflow-mcp-server

### What are the best alternatives to Airflow MCP Server?

The closest alternatives to Airflow MCP Server are Api Test MCP, Estuary Flow MCP by usefulapi, fastapi_mcp, Diagrid MCP Server and awesome-mcp-servers.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Api Test MCP](https://ai-powered.com/mcp/api-test-mcp): Api Test MCP is an open-source MCP server for developer tools.
- [Estuary Flow MCP by usefulapi](https://ai-powered.com/mcp/estuary-flow-mcp-by-usefulapi): Estuary Flow MCP by usefulapi is a freemium MCP server for developer tools.
- [fastapi_mcp](https://ai-powered.com/mcp/fastapi-mcp): fastapi_mcp is an open-source MCP server for ai models and llm tooling.
- [Diagrid MCP Server](https://ai-powered.com/mcp/diagrid-mcp-server): Diagrid MCP Server is a paid MCP server for cloud and infrastructure.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [Authentik MCP Server](https://ai-powered.com/mcp/authentik-mcp-server): Authentik MCP Server is an open-source MCP server for developer tools.
- [MCP Foundry — Build, Test & Publish MCP Servers](https://ai-powered.com/mcp/mcp-foundry-build-test-and-publish-mcp-servers): MCP Foundry — Build, Test & Publish MCP Servers is a freemium MCP server for developer tools.
- [Apollo MCP Server](https://ai-powered.com/mcp/apollo-mcp-server): Apollo MCP Server is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/airflow-mcp-server
