Argo CD MCP Server

Name: Argo CD MCP Server
Author: argoproj-labs

Inspect, sync and manage Argo CD applications, clusters and resources from an MCP client

By argoproj-labs TypeScript Local · stdio DevOps and monitoring Cloud platforms

GitHub npm Website

76 popularity score ★ 604 ↓ 27k/wk

Connect your client

Local (npm)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Opens the app, which asks before it adds the server. Then replace each <NAME> in its settings with your value.

Or add it by command or config

It needs ARGOCD_BASE_URL, ARGOCD_API_TOKEN. Replace each <NAME> with your value.

Claude CodeTerminal

claude mcp add argo-cd -e ARGOCD_BASE_URL=<ARGOCD_BASE_URL> -e ARGOCD_API_TOKEN=<ARGOCD_API_TOKEN> -- npx argocd-mcp@latest stdio

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "argo-cd": {
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<ARGOCD_BASE_URL>",
        "ARGOCD_API_TOKEN": "<ARGOCD_API_TOKEN>"
      }
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "argo-cd": {
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<ARGOCD_BASE_URL>",
        "ARGOCD_API_TOKEN": "<ARGOCD_API_TOKEN>"
      }
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "argo-cd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<ARGOCD_BASE_URL>",
        "ARGOCD_API_TOKEN": "<ARGOCD_API_TOKEN>"
      }
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.argo-cd]
command = "npx"
args = ["argocd-mcp@latest", "stdio"]

[mcp_servers.argo-cd.env]
ARGOCD_BASE_URL = "<ARGOCD_BASE_URL>"
ARGOCD_API_TOKEN = "<ARGOCD_API_TOKEN>"

Gemini CLITerminal

gemini mcp add --scope user -e ARGOCD_BASE_URL=<ARGOCD_BASE_URL> -e ARGOCD_API_TOKEN=<ARGOCD_API_TOKEN> argo-cd npx -- argocd-mcp@latest stdio

Local (container)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Opens the app, which asks before it adds the server. Then replace each <NAME> in its settings with your value.

Or add it by command or config

It needs ARGOCD_BASE_URL, ARGOCD_API_TOKEN. Replace each <NAME> with your value.

Claude CodeTerminal

claude mcp add argo-cd -e ARGOCD_BASE_URL=<ARGOCD_BASE_URL> -e ARGOCD_API_TOKEN=<ARGOCD_API_TOKEN> -- docker run -e 'ARGOCD_BASE_URL=<ARGOCD_BASE_URL>' -e 'ARGOCD_API_TOKEN=<ARGOCD_API_TOKEN>' argoprojlabs/mcp-for-argocd

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "argo-cd": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "ARGOCD_BASE_URL=<ARGOCD_BASE_URL>",
        "-e",
        "ARGOCD_API_TOKEN=<ARGOCD_API_TOKEN>",
        "argoprojlabs/mcp-for-argocd"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<ARGOCD_BASE_URL>",
        "ARGOCD_API_TOKEN": "<ARGOCD_API_TOKEN>"
      }
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "argo-cd": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "ARGOCD_BASE_URL=<ARGOCD_BASE_URL>",
        "-e",
        "ARGOCD_API_TOKEN=<ARGOCD_API_TOKEN>",
        "argoprojlabs/mcp-for-argocd"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<ARGOCD_BASE_URL>",
        "ARGOCD_API_TOKEN": "<ARGOCD_API_TOKEN>"
      }
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "argo-cd": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-e",
        "ARGOCD_BASE_URL=<ARGOCD_BASE_URL>",
        "-e",
        "ARGOCD_API_TOKEN=<ARGOCD_API_TOKEN>",
        "argoprojlabs/mcp-for-argocd"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<ARGOCD_BASE_URL>",
        "ARGOCD_API_TOKEN": "<ARGOCD_API_TOKEN>"
      }
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.argo-cd]
command = "docker"
args = ["run", "-e", "ARGOCD_BASE_URL=<ARGOCD_BASE_URL>", "-e", "ARGOCD_API_TOKEN=<ARGOCD_API_TOKEN>", "argoprojlabs/mcp-for-argocd"]

[mcp_servers.argo-cd.env]
ARGOCD_BASE_URL = "<ARGOCD_BASE_URL>"
ARGOCD_API_TOKEN = "<ARGOCD_API_TOKEN>"

Gemini CLITerminal

gemini mcp add --scope user -e ARGOCD_BASE_URL=<ARGOCD_BASE_URL> -e ARGOCD_API_TOKEN=<ARGOCD_API_TOKEN> argo-cd docker -- run -e 'ARGOCD_BASE_URL=<ARGOCD_BASE_URL>' -e 'ARGOCD_API_TOKEN=<ARGOCD_API_TOKEN>' argoprojlabs/mcp-for-argocd

Settings 7

`ARGOCD_BASE_URL`	Required: Address of the default Argo CD instance; may instead be passed per call as argocdBaseUrl.
`ARGOCD_API_TOKEN`	Required: Argo CD API token for the default instance; not needed when ARGOCD_TOKEN_REGISTRY_PATH is set.
`ARGOCD_TOKEN_REGISTRY_PATH`	Optional: Path to a JSON file mapping extra Argo CD base URLs to their tokens.
`MCP_READ_ONLY`	Optional: Set to true to disable the create, update, delete, sync and resource action tools.
`MCP_BIND_ADDRESS`	Optional: Address the HTTP listener binds to; defaults to 127.0.0.1.
`MCP_AUTH_TOKEN`	Optional: Bearer token every HTTP request must carry; needed when binding beyond loopback.
`NODE_TLS_REJECT_UNAUTHORIZED`	Optional: Set to 0 to accept self-signed Argo CD certificates; weakens TLS checks.

In a container, a setting goes in with -e NAME=value after docker run.

What it does

Argo CD MCP Server connects an MCP client to the REST API of an Argo CD instance, the GitOps continuous delivery tool for Kubernetes. Through it an assistant can list registered clusters and applications, read an application's details, resource tree and managed resources, pull workload logs and Kubernetes events, and look up an AppProject.

It can also act on the instance: create, update and delete applications, start a sync, and run resource actions such as a restart. Setting MCP_READ_ONLY to true removes those five tools, leaving only the reading ones.

It runs over stdio for desktop and editor clients (started with npx), or as an HTTP server, including a stateless mode meant for several replicas behind a Kubernetes autoscaler. A container image, argoprojlabs/mcp-for-argocd, is published for the HTTP setup. One server can reach several Argo CD instances: every tool takes an optional argocdBaseUrl argument, and tokens for extra instances come from a JSON token registry file.

The project sits in the argoproj-labs GitHub organisation, the Argo project's space for incubating projects; it was first written at Akuity and donated there.

What it needs

Runtime	Node.js 18+orDocker

Node.js 18 or newer for the npx route (or Docker for the image). A reachable Argo CD instance, its base URL, and an Argo CD API token for an account with the permissions the tools need; Argo CD's own docs explain how to create one.

Limits

Works only through the Argo CD API: it reaches Kubernetes objects only as far as Argo CD exposes them for its applications. The default token is never sent to any host other than the default base URL, so reaching another instance needs a token registry entry. HTTP sessions are held in memory, so several replicas need sticky sessions or the --stateless flag; in stateless mode GET and DELETE on /mcp are refused. Instances with self-signed certificates need NODE_TLS_REJECT_UNAUTHORIZED=0, which its README warns weakens security.

Who it suits

Platform and DevOps engineers who already run Argo CD and want to ask about application health, diffs, logs and events, or trigger syncs, from VS Code, Cursor or Claude Desktop. Because it can delete applications and run resource actions with whatever rights the token holds, teams that only want visibility should run it with MCP_READ_ONLY and a read-only Argo CD account. Teams wanting direct access to Kubernetes objects outside Argo CD should pick a Kubernetes server instead.

Tools 14 of 16

list_clusters: Lists the clusters registered in Argo CD
get_appproject: Returns one AppProject and its settings
list_applications: Lists applications, with filters
get_application: Returns the full definition and status of one application
create_application: Creates a new Argo CD application
update_application: Changes an existing application
delete_application: Removes an application
sync_application: Starts a sync of an application to its Git source
get_application_resource_tree: Returns the tree of Kubernetes resources behind an application
get_application_managed_resources: Returns the resources an application manages, with optional filtering
get_application_workload_logs: Fetches logs from an application's pods, deployments and other workloads
get_resource_events: Returns Kubernetes events for a resource an application manages
get_resource_actions: Lists the actions available on a managed resource
run_resource_action: Runs one of those actions on a managed resource

Popularity

76 popularity score, on our list (the bar is 36)

★ 604 ↓ 27k/wk

GitHub stars	604	33.4 points
Stars in 30 days	+23	6.9 points
npm downloads, last week	26,652	35.4 points

Measured 2026-11-07. How the score works.

Where it is published

Code	argoproj-labs/mcp-for-argocd ★ 604
npm	argocd-mcp 0.9.0, 2026-08-11, the one the command runs
Docker Hub	argoprojlabs/mcp-for-argocd

What it can reach

Runs	On your machine
Reaches	The internet, Cloud resources, Your account at a service
Changes things	Yes: it can write, send, create or delete
Sign-in	An API key or token
Licence	Apache-2.0 (npm)
Last code change	2026-08-11

Runs on your machine or in your own container and calls only the Argo CD API at the configured base URL, using an Argo CD API token; what it can do is bounded by that account's Argo CD permissions. Five tools change state: create_application, update_application, delete_application, sync_application and run_resource_action, which can redeploy or delete workloads in connected clusters. MCP_READ_ONLY=true disables them. Logs and events it reads may contain sensitive data. The default token is only sent to the default base URL. The HTTP transport listens on 127.0.0.1 by default and refuses a wider bind unless MCP_AUTH_TOKEN or --allow-unauthenticated is set; the Argo CD token does not protect the listener.

Over time

GitHub stars 604 +23 (+4 %)

604581

8 Oct 20267 Nov 2026

npm downloads a week 27k +26k (+4929 %)

40k286

20 Oct 20257 Nov 2026

Before the site measured it, read from npm's daily download counts.

Popularity score 76 +7 (+10 %)

7666

8 Oct 20267 Nov 2026

What is rising across the directory

Sources

Page checked 2026-10-14.

Badge for your README

Shows this server's rank in its category, and stars for a server that runs on your machine. It updates every hour.

MarkdownREADME.md

[![Argo CD MCP Server on EveryMCPServer](https://everymcpserver.com/badge/mcp-for-argocd.svg)](https://everymcpserver.com/servers/mcp-for-argocd)

Connect your client

Add in one click

Or add it by command or config

Add in one click

Or add it by command or config

Settings 7

What it does

What it needs

Limits

Who it suits

Tools 14 of 16

Similar servers

Kubernetes MCP Server

MCP Server Kubernetes

Render MCP Server

Harness MCP Server

Azure MCP Server

MCP DigitalOcean Integration