Argo CD MCP Server

Content

Argo CD MCP Server is an Argo Project Labs implementation of the Model Context Protocol for Argo CD. It lets Claude and other MCP clients inspect Argo CD clusters, applications, managed resources, workload logs, resource events, and resource actions through natural-language workflows.

The server supports stdio, SSE, and HTTP stream transports. It can also run in a read-only mode that omits modifying tools, which is the safer default for inspection and troubleshooting workflows.

Source Review

• https://argo-cd.readthedocs.io/en/stable/
• https://github.com/argoproj-labs/mcp-for-argocd
• https://github.com/argoproj-labs/mcp-for-argocd#readme
• https://registry.npmjs.org/argocd-mcp
• https://github.com/argoproj-labs/mcp-for-argocd/blob/main/README.md
• https://github.com/argoproj-labs/mcp-for-argocd/blob/main/package.json
• https://github.com/argoproj-labs/mcp-for-argocd/blob/main/src/server/server.ts
• https://github.com/argoproj-labs/mcp-for-argocd/blob/main/src/cmd/cmd.ts
• https://github.com/argoproj-labs/mcp-for-argocd/blob/main/LICENSE

These sources were reviewed on 2026-06-06. Prefer the Argo CD docs, repository README, package metadata, server source, transport command source, and license for current setup commands, transport modes, tool behavior, and read-only controls.

Features

• Argo Project Labs MCP server for Argo CD.
• NPM package argocd-mcp.
• Stdio, SSE, and HTTP stream transport modes.
• Stateless HTTP mode for multi-replica deployments without sticky sessions.
• Cluster listing with filters.
• Application listing, retrieval, creation, update, deletion, and sync tools.
• Resource tree and managed-resource inspection.
• Workload log retrieval for application workloads.
• Resource and application event retrieval.
• Resource action discovery and execution.
• Read-only mode that removes mutation tools.
• Cursor, VS Code, and Claude Desktop configuration examples.

Installation

Configure a local stdio MCP server with an Argo CD URL and API token. Start in read-only mode for inspection workflows:

{
  "mcpServers": {
    "argocd-mcp": {
      "command": "npx",
      "args": ["argocd-mcp@latest", "stdio"],
      "env": {
        "ARGOCD_BASE_URL": "<argocd-url>",
        "ARGOCD_API_TOKEN": "<argocd-token>",
        "MCP_READ_ONLY": "true"
      }
    }
  }
}

Only remove read-only mode after reviewing the API token scope, target applications, and approval process for sync or mutation tools.

Use Cases

• List Argo CD applications and clusters from Claude.
• Inspect an application's resource tree before debugging a rollout.
• Retrieve workload logs for a managed Pod, Deployment, or StatefulSet.
• Review resource events for a failing application.
• Compare managed resources before a sync.
• Trigger an application sync after human review.
• Run a resource action when the exact target and action are approved.
• Use stateless HTTP mode for reviewed multi-replica MCP deployments.

Safety and Privacy

Argo CD MCP can affect live Kubernetes deployments. Use read-only mode by default, keep API tokens least-privilege, and require human approval before create, update, delete, sync, prune, or resource-action calls. Dry-run syncs are safer but still need target and revision review.

Treat logs, events, manifests, repository URLs, revisions, cluster names, and resource metadata as sensitive operational data. Avoid disabling TLS verification except in tightly controlled development environments, and restrict HTTP transport to trusted clients and networks.

Duplicate Check

No Argo CD MCP Server, ArgoCD MCP, argoproj-labs/mcp-for-argocd, or argocd-mcp entry was found in content/mcp, content/tools, content/guides, content/agents, or content/skills. Existing Argo CD mentions are incidental DevOps/SRE examples.