Skip to content
MCP server

Argo CD

Argo CD application status, sync, rollback, drift checks and ApplicationSets

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.9.0
Listing updated
3 days ago

About Argo CD

Argo CD is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Aimed at people running Kubernetes deployments through Argo CD, it needs only an API token and the server URL, not direct cluster access. The README lists 37 tools, 7 resources and 7 prompts.

The assistant can triage application status, trigger sync or rollback, inspect drift, read logs and manage ApplicationSets, clusters, projects and repositories. Nine write tools exist, and setting MCP_READ_ONLY keeps them from ever being offered to the model. MCP_TOOLSETS can narrow the list to apps, appsets or admin.

It targets Argo CD 3.3 and later, including OSS, Akuity and OpenShift GitOps installs. It runs over stdio from PyPI via uvx, with an optional bearer token when binding an HTTP transport to a non-loopback host.

Install

Run in a terminal

claude mcp add mcp-argocd --env ARGOCD_TOKEN='<ARGOCD_TOKEN>' --env ARGOCD_URL='<ARGOCD_URL>' --env ARGOCD_HTTP_BEARER_TOKEN='<ARGOCD_HTTP_BEARER_TOKEN>' -- uvx mcp-argocd

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-argocd": {
      "command": "uvx",
      "args": [
        "mcp-argocd"
      ],
      "env": {
        "ARGOCD_TOKEN": "<ARGOCD_TOKEN>",
        "ARGOCD_URL": "<ARGOCD_URL>",
        "ARGOCD_HTTP_BEARER_TOKEN": "<ARGOCD_HTTP_BEARER_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-argocd": {
      "command": "uvx",
      "args": [
        "mcp-argocd"
      ],
      "env": {
        "ARGOCD_TOKEN": "<ARGOCD_TOKEN>",
        "ARGOCD_URL": "<ARGOCD_URL>",
        "ARGOCD_HTTP_BEARER_TOKEN": "<ARGOCD_HTTP_BEARER_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-argocd": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-argocd"
      ],
      "env": {
        "ARGOCD_TOKEN": "<ARGOCD_TOKEN>",
        "ARGOCD_URL": "<ARGOCD_URL>",
        "ARGOCD_HTTP_BEARER_TOKEN": "<ARGOCD_HTTP_BEARER_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-argocd": {
      "command": "uvx",
      "args": [
        "mcp-argocd"
      ],
      "env": {
        "ARGOCD_TOKEN": "<ARGOCD_TOKEN>",
        "ARGOCD_URL": "<ARGOCD_URL>",
        "ARGOCD_HTTP_BEARER_TOKEN": "<ARGOCD_HTTP_BEARER_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-argocd": {
      "command": "uvx",
      "args": [
        "mcp-argocd"
      ],
      "env": {
        "ARGOCD_TOKEN": "<ARGOCD_TOKEN>",
        "ARGOCD_URL": "<ARGOCD_URL>",
        "ARGOCD_HTTP_BEARER_TOKEN": "<ARGOCD_HTTP_BEARER_TOKEN>"
      }
    }
  }
}

Configuration

  • ARGOCD_TOKENArgo CD bearer token (also accepts ARGOCD_AUTH_TOKEN or ARGOCD_API_TOKEN)Required
  • ARGOCD_URLArgo CD base URL including any path prefix (e.g. https://argocd.example.com)Required
  • ARGOCD_READ_ONLYAlias for MCP_READ_ONLY. Any value other than false/0/no/off/empty locks the server read-only; --read-only can only raise the lock
  • MCP_READ_ONLYLocks the server read-only: write tools and write-workflow prompts are not listed and nothing lifts the lock at runtime. Shared name across the mcp-* servers; set it in the deployer's env
  • MCP_TOOLSETSComma list of tool groups to expose (apps, appsets, admin); unset or 'all' lists every tool. Shrinks tools/list for clients with a tool budget; MCP_READ_ONLY still applies after the selection
  • ARGOCD_HTTP_BEARER_TOKENBearer token (min 16 chars) required to bind an HTTP transport to a non-loopback host; clients send it as 'Authorization: Bearer <token>'

What it does

Application triage
Reads application status and logs to find what is unhealthy.
Sync and rollback
Triggers sync and rollback operations.
Drift inspection
Compares live state against the desired state.
ApplicationSets
Manages ApplicationSets plus clusters, projects and repositories.
Read-only lock
Withholds the 9 write tools when MCP_READ_ONLY is set.
Token-only access
Needs an Argo CD API token, not cluster credentials.

Good for

  • Ask which applications are out of sync and why
  • Roll back a bad release from a chat
  • Pull logs for a failing application
  • Audit ApplicationSets and registered clusters

Pricing

Open source

MIT-licensed; installs with uvx.

Prices change. Check vish288.github.io before you buy.

Argo CD FAQ

Which Argo CD versions work?

Argo CD 3.3 and later, on OSS, Akuity or OpenShift GitOps.

Does it need kubectl or cluster access?

No, only an API token and the Argo CD URL.

Can I stop it from changing deployments?

Yes. With MCP_READ_ONLY=true the 9 write tools are never listed.

What are the required settings?

ARGOCD_URL and ARGOCD_TOKEN.

Is Argo CD free?

Yes. Argo CD is open source, so you can use and self-host it for free.

How do I add Argo CD to Claude Code?

Run this command in your terminal: claude mcp add mcp-argocd --env ARGOCD_TOKEN='<ARGOCD_TOKEN>' --env ARGOCD_URL='<ARGOCD_URL>' --env ARGOCD_HTTP_BEARER_TOKEN='<ARGOCD_HTTP_BEARER_TOKEN>' -- uvx mcp-argocd

What are the best alternatives to Argo CD?

The closest alternatives to Argo CD are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Argo CD

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools