PlugWiki
argocd-mcp logo

Argo CD MCP Server: Setup for Claude Code, Cursor and Other Apps

CommunityLocal

Lets Claude, Cursor and other assistants list, inspect, sync and manage your Argo CD applications and read their logs.

This server connects your assistant to an Argo CD instance through its API. Ask it which applications are out of sync, why a deployment is failing, or to sync one. It can also create, update and delete applications.

It runs on your machine and needs your Argo CD address and an API token. Your assistant can do whatever that token is allowed to do, so give it a token with only the permissions you want.

Set the read-only switch in the install box if you only want to look.

Good for

  • Platform and DevOps engineers who run Argo CD
  • On-call engineers checking app health, events and logs from the chat
  • Teams that want to sync or inspect GitOps apps without opening the web UI

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install argocd MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the argocd MCP server to Claude Code. Run this command:
    
    claude mcp add argocd -e ARGOCD_BASE_URL=<ARGOCD_BASE_URL> -e ARGOCD_API_TOKEN=<ARGOCD_API_TOKEN> -- npx -y argocd-mcp stdio
    
    Ask me for ARGOCD_BASE_URL, ARGOCD_API_TOKEN and only put the values in that config, nowhere else.
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Read-only mode: Add MCP_READ_ONLY set to true to the server's environment. That removes the tools that create, update, delete or sync applications and run resource actions.

Replace the two placeholders with your Argo CD address and an API token. The command ends in the stdio option because the server needs a mode argument to start in standard-input mode. Create the token with the steps in the Argo CD API docs. Set MCP_READ_ONLY to true in the same env block to turn off the tools that change things. Node.js 18 or newer is recommended.

Built from the package data we hold. Not yet tested by us.

Tools

  • Lists your Argo CD applications, with optional search

    Returns the applications Argo CD manages. You can search by name and page through long lists to keep results short.

    Try: “List the Argo CD applications with "payments" in the name.”

    Network · list_applications

  • Shows the details of one application

    Returns the full record for an application, including its source, destination and sync state.

    Try: “Show me the details of the checkout application.”

    Network · get_application

  • Lists the clusters registered with Argo CD

    Returns registered clusters, which you can filter by name or server address.

    Try: “Which clusters does Argo CD deploy to?”

    Network · list_clusters

  • Shows the details of one Argo CD project

    Returns the settings of a project, such as what repos and clusters it allows.

    Try: “Show the settings of the platform project.”

    Network · get_appproject

  • Shows the tree of resources an application runs

    Returns the resources the application created, laid out from parent to child.

    Try: “Show the resource tree for the checkout application.”

    Network · get_application_resource_tree

  • Lists the resources an application manages

    Returns the cluster resources Argo CD tracks for an application.

    Try: “Which resources does checkout manage?”

    Network · get_application_managed_resources

  • Reads logs from an application's pods and workloads

    Fetches log lines from the workloads behind an application.

    Try: “Show the latest logs from the checkout pods.”

    Network · get_application_workload_logs

  • Shows recent events for an application

    Returns the events Argo CD recorded for an application.

    Try: “What happened to the checkout application today?”

    Network · get_application_events

  • Shows recent events for one resource

    Returns events for a single resource that an application manages, such as one deployment.

    Try: “Show events for the checkout deployment.”

    Network · get_resource_events

  • Fetches the manifests of an application's resources

    Returns the live definitions of resources managed by an application.

    Try: “Show the manifest of the checkout service.”

    Network · get_resources

  • Lists the actions a resource supports

    Shows which actions Argo CD offers for a resource, such as restart.

    Try: “What actions can I run on the checkout deployment?”

    Network · get_resource_actions

  • Creates a new Argo CD application

    Creates an application in the namespace you give. Hidden when read-only mode is on.

    Try: “Create an application for the repo my-org/api in the staging cluster.”

    Write · create_application

Read from the source code

Permissions

high risk · 4 things to watch · 1 advisory

High risk

By default it can create, change, sync and delete applications, and deleting or pruning can remove the cluster resources behind them. Turn on read-only mode and use an Argo CD token limited to the projects you need.

What it can do

Watch out for

  • It can delete applications and their resources

    Delete can cascade to child resources, and sync can prune resources. Turn on read-only mode unless you need changes. github.com

  • It can run actions on live workloads

    The resource action tool runs actions such as restarts on the cluster. Review each call before approving it. github.com

  • The network modes need a lock

    The README says the HTTP and SSE modes bind to loopback by default, and widening that needs MCP_AUTH_TOKEN or an explicit no-auth flag. Do not expose the port without one. github.com

  • The README suggests turning off certificate checks

    For self-signed certificates it shows setting NODE_TLS_REJECT_UNAUTHORIZED to 0. Use that only in development. github.com

Security advisories

Technical details
Turning on read-onlySet MCP_READ_ONLY=true in the server environment. This removes create_application, update_application, delete_application, sync_application and run_resource_action.
Talks toYour Argo CD server (the address you set)
Sign-in and keysThe Argo CD API token goes in the ARGOCD_API_TOKEN environment variable (or an HTTP header in HTTP mode). The README says the token is never read from a tool call.
Scopes
  • Whatever the Argo CD API token you provide is allowed to do

Questions

What do I need to connect the Argo CD MCP server?

Your Argo CD address and an API token. Set them as ARGOCD_BASE_URL and ARGOCD_API_TOKEN in the install box. Node.js 18 or newer is recommended.

Can I run it read-only?

Yes. Set MCP_READ_ONLY to true and the five tools that change things are not offered. The 11 read tools stay, including pod logs and events.

Can it delete my applications?

Yes, unless read-only mode is on. Deleting can cascade to the resources an application created, and syncing can prune resources.

Is it the official Argo CD MCP server?

No, it is not an official Argo project release. It lives in argoproj-labs, an organization the Argo maintainers manage that is not part of the Argo CNCF projects. The README says it was created and donated by engineers from Akuity.

Does it work with more than one Argo CD instance?

Yes. Every tool accepts an optional base URL. The default token only goes to the default address, and other instances need a token registry file.

Does it run locally or in the cloud?

Locally. Your assistant starts it on your machine, and it calls your Argo CD API. A Docker image and HTTP mode also exist for team setups.

Why does the command end with stdio?

The server needs a mode argument. The README's client configs use stdio for local use.

Information

updated Nov 2, 2026

Publisher
Community
Package
argocd-mcp
Registry
npm
Transport
stdio, Streamable HTTP
Auth
token in env
Version
0.9.0
License
Apache-2.0
Last commit
Oct 16, 2026

GitHubnpmChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. mcp-for-argocd README · github.com
  2. mcp-for-argocd server.ts · github.com
  3. argocd-mcp on npm · npmjs.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.