
Argo CD MCP Server: Setup for Claude Code, Cursor and Other Apps
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install argocd MCP
Claude Code
- 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
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_applicationsShows 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_applicationLists 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_clustersShows 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_appprojectShows 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_treeLists 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_resourcesReads 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_logsShows 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_eventsShows 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_eventsFetches 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_resourcesLists 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_actionsCreates 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_applicationChanges an existing application
Updates an application's definition. Hidden when read-only mode is on.
Try: “Point the checkout application at the release branch.”
Write ·
update_applicationDeletes an application
Removes an application from Argo CD. You can choose whether the deletion cascades to the resources it created. Hidden when read-only mode is on.
Try: “Delete the old demo application.”
Delete ·
delete_applicationSyncs an application to match its source
Applies the source state to the cluster. It supports a dry run, pruning of resources no longer in the source, and a chosen revision. Hidden when read-only mode is on.
Try: “Sync checkout with a dry run first.”
Delete ·
sync_applicationRuns an action on a resource
Runs one of the actions a resource offers, such as restarting a deployment. Hidden when read-only mode is on.
Try: “Restart the checkout deployment.”
Write ·
run_resource_action
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
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
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-only | Set MCP_READ_ONLY=true in the server environment. This removes create_application, update_application, delete_application, sync_application and run_resource_action. |
|---|---|
| Talks to | Your Argo CD server (the address you set) |
| Sign-in and keys | The 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 |
|
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
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- mcp-for-argocd README · github.com
- mcp-for-argocd server.ts · github.com
- argocd-mcp on npm · npmjs.com