Argo CD MCP

MCP server for Argo CD applications: list, inspect, sync and manage apps.

By defaultCan delete
With our presetRead-only

Labels are provisional (from the project README/docs, checked Nov 3, 2026). Not yet tested in our sandbox.

Read-only switch

MCP_READ_ONLY=true disables create/update/delete/sync tools.

Preset

Read-onlyRead-only switch from the vendor's docs. Not sandbox-tested yet.
What the preset changes
  • Pins @0.9.0: the read-only switch needs 0.3.0 or later.
  • Set MCP_READ_ONLY=true

Claude Code

.mcp.json
{
  "mcpServers": {
    "argocd": {
      "command": "npx",
Removed:       "args": ["argocd-mcp", "stdio"],
      "args": ["argocd-mcp@0.9.0", "stdio"],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "<argocd_token>",
        "MCP_READ_ONLY": "true"
      }
    }
  }
}

Optional third layer: add "deny": ["mcp__argocd__<write tool>"] under permissions in .claude/settings.json.

Codex

~/.codex/config.toml
# Generated by redpresets.dev on 2026-11-03. Unverified preset. Also use a read-only credential. Not a security guarantee.

[mcp_servers.argocd]
command = "npx"
Removed: args = ["argocd-mcp", "stdio"]
args = ["argocd-mcp@0.9.0", "stdio"]
default_tools_approval_mode = "writes"

[mcp_servers.argocd.env]
ARGOCD_BASE_URL = "<argocd_url>"
ARGOCD_API_TOKEN = "<argocd_token>"
MCP_READ_ONLY = "true"

default_tools_approval_mode = "writes" asks before any tool the server does not mark read-only.

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "argocd": {
      "type": "stdio",
      "command": "npx",
Removed:       "args": ["argocd-mcp", "stdio"],
      "args": ["argocd-mcp@0.9.0", "stdio"],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "<argocd_token>",
        "MCP_READ_ONLY": "true"
      }
    }
  }
}

Don't add write tools to mcpAllowlist in .cursor/permissions.json. Leave them on approval. Cursor's docs say the allowlist is not a security boundary.

Lines marked + are what we added to the vendor's install command. Struck-through lines marked − are what they replaced; Copy leaves those out.

Credential layer

Create an Argo CD account/project role with only get on applications and use its token. A sync-capable token can redeploy anything.

Facts

Vendor
argoproj-labs official
Source
argoproj-labs/mcp-for-argocd
License
Apache-2.0
GitHub stars
597
Latest release
v0.9.0 (Aug 11, 2026)
Last push
Oct 16, 2026
Status
Active
Last checked
Nov 3, 2026

Sources

Spotted something wrong? Labels change when vendors change. Suggest a correction

Read-only alternatives in Kubernetes