Skip to content

Airbyte MCP Server

List and inspect Airbyte connectors, validate connector configs, deploy sources and destinations to Airbyte Cloud, and run and monitor syncs.

Capabilities
List connectors Validate configs Deploy to Airbyte Cloud Run syncs Check sync status
Maintained by
Airbyte
Hosting
Runs locally on your machine
Authentication
API key or credentials (environment variables)
Last checked

Experimental and part of PyAirbyte; safe mode is on by default and blocks changes to objects not created in the current session.

How to connect the Airbyte MCP server

Pick your AI client and paste the snippet. Swap the YOUR_… placeholders for your own values. New to this? Our guide to how MCP clients and servers fit together explains what each piece does.

Claude Code

Terminal
claude mcp add --env AIRBYTE_CLOUD_CLIENT_ID=YOUR_AIRBYTE_CLIENT_ID --env AIRBYTE_CLOUD_CLIENT_SECRET=YOUR_AIRBYTE_CLIENT_SECRET --env AIRBYTE_CLOUD_WORKSPACE_ID=YOUR_AIRBYTE_WORKSPACE_ID --transport stdio airbyte \
  -- uvx --python=3.11 --from=airbyte@latest airbyte-mcp
Full Claude Code setup guide →

Claude Desktop

claude_desktop_config.json (Settings → Developer → Edit Config)
{
  "mcpServers": {
    "airbyte": {
      "command": "uvx",
      "args": [
        "--python=3.11",
        "--from=airbyte@latest",
        "airbyte-mcp"
      ],
      "env": {
        "AIRBYTE_CLOUD_CLIENT_ID": "YOUR_AIRBYTE_CLIENT_ID",
        "AIRBYTE_CLOUD_CLIENT_SECRET": "YOUR_AIRBYTE_CLIENT_SECRET",
        "AIRBYTE_CLOUD_WORKSPACE_ID": "YOUR_AIRBYTE_WORKSPACE_ID"
      }
    }
  }
}

Fully quit and reopen Claude Desktop after saving.

Full Claude Desktop setup guide →

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project)
{
  "mcpServers": {
    "airbyte": {
      "command": "uvx",
      "args": [
        "--python=3.11",
        "--from=airbyte@latest",
        "airbyte-mcp"
      ],
      "env": {
        "AIRBYTE_CLOUD_CLIENT_ID": "YOUR_AIRBYTE_CLIENT_ID",
        "AIRBYTE_CLOUD_CLIENT_SECRET": "YOUR_AIRBYTE_CLIENT_SECRET",
        "AIRBYTE_CLOUD_WORKSPACE_ID": "YOUR_AIRBYTE_WORKSPACE_ID"
      }
    }
  }
}
Full Cursor setup guide →

VS Code

.vscode/mcp.json
{
  "servers": {
    "airbyte": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--python=3.11",
        "--from=airbyte@latest",
        "airbyte-mcp"
      ],
      "env": {
        "AIRBYTE_CLOUD_CLIENT_ID": "YOUR_AIRBYTE_CLIENT_ID",
        "AIRBYTE_CLOUD_CLIENT_SECRET": "YOUR_AIRBYTE_CLIENT_SECRET",
        "AIRBYTE_CLOUD_WORKSPACE_ID": "YOUR_AIRBYTE_WORKSPACE_ID"
      }
    }
  }
}
Full VS Code setup guide →

Frequently asked questions

What is the Airbyte MCP server?

It is a Model Context Protocol (MCP) server — a small piece of software that gives AI assistants like Claude a secure, governed connection to Airbyte. List and inspect Airbyte connectors, validate connector configs, deploy sources and destinations to Airbyte Cloud, and run and monitor syncs.

Is there an official Airbyte MCP server?

Yes. The Airbyte MCP server is an official integration, maintained by the vendor or the Model Context Protocol project, which makes it the safest default for business use. It is maintained by Airbyte.

Is the Airbyte MCP server hosted, or do I run it myself?

It runs locally. Your AI client starts it on your own machine with uvx, and it talks to the client over standard input and output rather than the network.

Do I need an API key for the Airbyte MCP server?

Yes. The local server reads AIRBYTE_CLOUD_CLIENT_ID, AIRBYTE_CLOUD_CLIENT_SECRET, AIRBYTE_CLOUD_WORKSPACE_ID from its environment, so you create those credentials first and add them to your client's config.

What can an AI assistant actually do with Airbyte?

Through this server an assistant can work with list connectors, validate configs, deploy to airbyte cloud, run syncs, check sync status — reading from and acting on Airbyte directly instead of you copy-pasting between windows. What you allow it to do is controlled by the permissions you grant.

How do I set this up for my business?

The setup section above has copy-paste config for Claude Code, Claude Desktop, Cursor and VS Code. If you want it rolled out across a team with permissions, governance and support handled, that is what Crox's Build engagement covers.

New to MCP? Start with our plain-English guide to the Model Context Protocol or see how to connect AI to your business tools without writing code .

Done-for-you integration

Want this connected to your business — with governance handled?

Crox maps your processes, connects AI to the tools you already use, and keeps it working as models change. Start with a readiness assessment or talk to us about a build.