# Argo CD

> Argo CD is an open-source MCP server for developer tools. Argo CD application status, sync, rollback, drift checks and ApplicationSets. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://vish288.github.io/mcp-install?server=mcp-argocd
- **Repository:** https://github.com/vish288/mcp-argocd
- **MCP Registry name:** io.github.vish288/mcp-argocd
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

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

```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>"
      }
    }
  }
}
```

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/argo-cd
