Argocd MCP Server

An MCP (Model Context Protocol) server that integrates with the ArgoCD API, enabling AI assistants and large language models to manage ArgoCD

Local serverstdioPython

What is the Argocd MCP Server?

Argocd MCP connects Argocd MCP to AI assistants that speak the Model Context Protocol. An MCP (Model Context Protocol) server that integrates with the ArgoCD API, enabling AI assistants and large language models to manage ArgoCD applications and resources through natural language interactions.

What Argocd MCP does

An MCP (Model Context Protocol) server that integrates with the ArgoCD API, enabling AI assistants and large language models to manage ArgoCD applications and resources through natural language interactions.

Key capabilities

  • Authentication & Session Management —
  • User info retrieval from ArgoCD API
  • Token-based authentication with ArgoCD
  • Server settings and configuration access
  • Plugin information retrieval
  • Version information retrieval
  • Application Management —
  • List and filter applications by project, name, namespace

Requirements

  • Python 3.12+ - MCP (includes FastMCP and development tools) - uv package manager (recommended) or pip - ArgoCD API token

Practical notes

  • Maintained by severity1, written in Python.

Recorded tools

  • get_user_info — Get the current user's info via api/v1/session/userinfo
  • get_settings — Get ArgoCD server settings including UI, OIDC, and other configurations
  • get_plugins — Get information about configured ArgoCD plugins
  • get_version — Get version information of the API server
  • list_applications — Get all applications with filtering options
  • get_application_details — Get detailed information about a specific application
  • create_application — Create a new application
  • update_application — Update an existing application
  • delete_application — Delete an application
  • sync_application — Trigger a sync operation on an application

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_user_infoGet the current user's info via api/v1/session/userinfo
get_settingsGet ArgoCD server settings including UI, OIDC, and other configurations
get_pluginsGet information about configured ArgoCD plugins
get_versionGet version information of the API server
list_applicationsGet all applications with filtering options
get_application_detailsGet detailed information about a specific application
create_applicationCreate a new application
update_applicationUpdate an existing application
delete_applicationDelete an application
sync_applicationTrigger a sync operation on an application

How to install the Argocd MCP Server

{
  "mcpServers": {
    "argocd-mcp": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/argocd-mcp",
        "run",
        "server.py"
      ],
      "env": {
        "ARGOCD_TOKEN": "YOUR_ARGOCD_TOKEN",
        "ARGOCD_API_URL": "https://your-argocd-server.com/api/v1",
        "ARGOCD_VERIFY_SSL": "true"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.12+ - MCP (includes FastMCP and development tools) - uv package manager (recommended) or pip - ArgoCD API token
VariableDescriptionRequired
ARGOCD_TOKENDeclared in the maintainer’s client configuration.Check documentation
ARGOCD_API_URLDeclared in the maintainer’s client configuration.Check documentation
ARGOCD_VERIFY_SSLDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Argocd MCP to get user info.”
  • “Use Argocd MCP to get settings.”
  • “Use Argocd MCP to get plugins.”

Frequently asked questions

An MCP (Model Context Protocol) server that integrates with the ArgoCD API, enabling AI assistants and large language models to manage ArgoCD applications and Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.