Argo CD
Argo CD application status, sync, rollback, drift checks and ApplicationSets
- 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-argocdAdd 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)RequiredARGOCD_URLArgo CD base URL including any path prefix (e.g. https://argocd.example.com)RequiredARGOCD_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 lockMCP_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 envMCP_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 selectionARGOCD_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools