Argocd

io.github.asklokeshPublished by GitHub account asklokeshv0.1.0Updated Oct 24, 2026

MCP server for ArgoCD GitOps continuous delivery integration

VerifiedSTDIODesktop onlyCloud & InfrastructureDeveloper Tools

Overview

AI-generated overview

An MCP server that connects an AI assistant to ArgoCD, letting it manage GitOps applications, projects, repositories, clusters and sync operations.

What you can do
List, create, sync, roll back and delete ArgoCD applications, and read their status and health. Create and configure projects, roles and policies. Add or remove Git and Helm repositories, and register Kubernetes clusters. Create ApplicationSets for template-based multi-cluster deployments. Inspect application health, sync status and resource trees.
When to use it
Useful when you run ArgoCD for Kubernetes GitOps delivery and want an assistant to inspect deployment state, trigger or roll back syncs, or set up projects, repositories and clusters from a conversation instead of the ArgoCD UI or CLI.
Requirements
Runs locally as a Python package (pip or uvx). Needs network access to an ArgoCD server, its API URL and an API key supplied through environment variables; the README also shows server, auth token and optional TLS certificate settings. Desktop client only.
Before you install
The API key grants access to a continuous-delivery system: tools can create, sync, roll back and delete applications, change projects and RBAC, and register clusters, so a mistake can alter or remove live Kubernetes workloads. Repository and cluster tools take credentials such as Git passwords and cluster bearer tokens. Use a minimally privileged service account and review actions before confirming.

Installation

In SourceWeft

  1. Open Argocd in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ArgoCD MCP Server

A Model Context Protocol (MCP) server for integrating ArgoCD GitOps continuous delivery tool with GenAI applications, enabling intelligent Kubernetes deployment management.

Features

  • Comprehensive ArgoCD API Coverage:

    • Application Management: Create, sync, delete, rollback applications
    • Project Management: Configure projects, roles, and policies
    • Repository Management: Add/remove Git repositories, Helm charts
    • Cluster Management: Register and manage Kubernetes clusters
    • Sync Operations: Manual/auto sync, sync windows, hooks
    • Health Monitoring: Application health, sync status, resource tree
    • RBAC Management: Users, roles, policies, JWT tokens
    • GitOps Workflows: Automated deployments from Git commits
    • Multi-tenancy: Namespace isolation, project restrictions
    • Application Sets: Template-based multi-cluster deployments
  • Authentication Methods:

    • JWT Token authentication
    • API Token authentication
    • OIDC/OAuth2 integration
    • LDAP authentication support
  • Enterprise Features:

    • Multi-cluster support
    • Disaster recovery workflows
    • Progressive delivery (Canary, Blue-Green)
    • Automated rollback on failures
    • Audit logging and compliance
    • Resource optimization
    • Secret management integration

Installation

bash
pip install argocd-mcp-server

Or install from source:

bash
git clone https://github.com/asklokesh/argocd-mcp-server.gitcd argocd-mcp-serverpip install -e .

Configuration

Create a .env file or set environment variables:

env
# ArgoCD ConnectionARGOCD_SERVER=argocd.example.comARGOCD_AUTH_TOKEN=your_auth_tokenARGOCD_INSECURE=false
# Optional SettingsARGOCD_GRPC_WEB=trueARGOCD_TIMEOUT=30ARGOCD_CLIENT_CERT=/path/to/cert.pemARGOCD_CLIENT_KEY=/path/to/key.pem
# Multi-Cluster SupportARGOCD_PROD_SERVER=argocd-prod.example.comARGOCD_PROD_TOKEN=prod_token
ARGOCD_DEV_SERVER=argocd-dev.example.comARGOCD_DEV_TOKEN=dev_token

Quick Start

Basic Usage

python
from argocd_mcp import ArgoCDMCPServer
# Initialize the serverserver = ArgoCDMCPServer()
# Start the serverserver.start()

Claude Desktop Configuration

Add to your Claude Desktop config:

json
{  "mcpServers": {    "argocd": {      "command": "python",      "args": ["-m", "argocd_mcp.server"],      "env": {        "ARGOCD_SERVER": "argocd.example.com",        "ARGOCD_AUTH_TOKEN": "your_auth_token"      }    }  }}

Available Tools

Application Management

List Applications
python
{  "tool": "argocd_list_applications",  "arguments": {    "project": "default",    "namespace": "argocd"  }}
Create Application
python
{  "tool": "argocd_create_application",  "arguments": {    "name": "my-app",    "project": "default",    "source": {      "repoURL": "https://github.com/org/repo.git",      "path": "manifests",      "targetRevision": "main"    },    "destination": {      "server": "https://kubernetes.default.svc",      "namespace": "production"    },    "syncPolicy": {      "automated": {        "prune": true,        "selfHeal": true      }    }  }}
Sync Application
python
{  "tool": "argocd_sync_application",  "arguments": {    "name": "my-app",    "prune": true,    "force": false,    "strategy": {      "hook": {        "force": true      }    }  }}
Get Application Status
python
{  "tool": "argocd_get_application_status",  "arguments": {    "name": "my-app",    "refresh": true  }}
Rollback Application
python
{  "tool": "argocd_rollback_application",  "arguments": {    "name": "my-app",    "revision": "abc123"  }}

Project Management

Create Project
python
{  "tool": "argocd_create_project",  "arguments": {    "name": "production",    "description": "Production applications",    "sourceRepos": ["https://github.com/org/*"],    "destinations": [      {        "server": "https://kubernetes.default.svc",        "namespace": "prod-*"      }    ],    "clusterResourceWhitelist": [      {"group": "*", "kind": "*"}    ]  }}

Repository Management

Add Repository
python
{  "tool": "argocd_add_repository",  "arguments": {    "url": "https://github.com/org/repo.git",    "name": "my-repo",    "type": "git",    "username": "git-user",    "password": "git-token",    "insecure": false  }}
Add Helm Repository
python
{  "tool": "argocd_add_helm_repository",  "arguments": {    "url": "https://charts.example.com",    "name": "my-charts",    "type": "helm",    "username": "helm-user",    "password": "helm-password"  }}

Cluster Management

Add Cluster
python
{  "tool": "argocd_add_cluster",  "arguments": {    "name": "production-cluster",    "server": "https://k8s-prod.example.com",    "config": {      "bearerToken": "cluster-token",      "tlsClientConfig": {        "insecure": false,        "caData": "base64-encoded-ca"      }    }  }}

Application Sets

Create ApplicationSet
python
{  "tool": "argocd_create_applicationset",  "arguments": {    "name": "multi-cluster-app",    "generators": [      {        "clusters": {},        "selector": {          "matchLabels": {            "environment": "production"          }        }      }    ],    "template": {      "metadata": {        "name": "{{cluster}}-app"      },      "spec": {        "project": "default",        "source": {          "repoURL": "https://github.com/org/repo.git",          "path": "{{cluster}}"        },        "destination": {          "server": "{{server}}",          "namespace": "default"        }      }    }  }}

Health and Monitoring

Get Application Health
python
{  "tool": "argocd_get_application_health",  "arguments": {    "name": "my-app"  }}
Get Resource Tree
python
{  "tool": "argocd_get_resource_tree",  "arguments": {    "name": "my-app"  }}

Advanced Configuration

Multi-Cluster GitOps

python
from argocd_mcp import ArgoCDMCPServer, ClusterConfig
# Configure multiple ArgoCD instancesclusters = {    "production": ClusterConfig(        server="argocd-prod.example.com",        auth_token="prod_token",        default_namespace="argocd"    ),    "staging": ClusterConfig(        server="argocd-staging.example.com",        auth_token="staging_token",        default_namespace="argocd-staging"    ),    "development": ClusterConfig(        server="argocd-dev.example.com",        auth_token="dev_token",        default_namespace="argocd-dev"    )}
server = ArgoCDMCPServer(clusters=clusters, default_cluster="production")

Progressive Delivery

python
# Configure progressive delivery strategiesprogressive_config = {    "canary": {        "steps": [            {"setWeight": 10},            {"pause": {"duration": "5m"}},            {"setWeight": 30},            {"pause": {"duration": "5m"}},            {"setWeight": 50},            {"pause": {"duration": "5m"}},            {"setWeight": 100}        ]    },    "blueGreen": {        "activeService": "app-active",        "previewService": "app-preview",        "autoPromotionEnabled": false    }}
server = ArgoCDMCPServer(progressive_config=progressive_config)

Disaster Recovery

python
from argocd_mcp import ArgoCDMCPServer, DisasterRecoveryConfig
dr_config = DisasterRecoveryConfig(    backup_enabled=True,    backup_schedule="0 2 * * *",  # Daily at 2 AM    backup_location="s3://backups/argocd",    restore_priority=["production", "staging", "development"])
server = ArgoCDMCPServer(dr_config=dr_config)

Integration Examples

See the examples/ directory for complete integration examples:

  • basic_gitops.py - Basic GitOps workflows
  • multi_cluster_deployment.py - Multi-cluster application deployment
  • progressive_delivery.py - Canary and blue-green deployments
  • disaster_recovery.py - Backup and restore workflows
  • genai_gitops.py - AI-powered GitOps automation
  • security_scanning.py - Integration with security tools

Security Best Practices

  1. Use service accounts with minimal permissions
  2. Enable RBAC with proper policies
  3. Implement network policies for cluster isolation
  4. Use sealed secrets or external secret operators
  5. Enable audit logging for compliance
  6. Implement admission controllers for policy enforcement
  7. Regular security scanning of images and manifests

Error Handling

The server provides detailed error information:

python
try:    result = server.execute_tool("argocd_sync_application", {        "name": "my-app"    })except ArgoCDError as e:    print(f"ArgoCD error: {e.error_code} - {e.message}")    if e.error_code == "OutOfSync":        print("Application is out of sync")    elif e.error_code == "ComparisonError":        print("Error comparing application state")

Performance Optimization

  1. Use application sets for similar apps
  2. Enable resource caching in ArgoCD
  3. Implement sync windows to control deployment times
  4. Use webhook notifications instead of polling
  5. Optimize manifest generation with Helm/Kustomize

Troubleshooting

Common Issues

  1. Sync failures

    • Check application logs
    • Verify repository access
    • Review resource quotas
  2. Authentication errors

    • Verify token validity
    • Check RBAC policies
    • Review server connectivity
  3. Performance issues

    • Check ArgoCD server resources
    • Review application count
    • Optimize manifest size

Contributing

Contributions are welcome! Please read our contributing guidelines and submit pull requests.

License

MIT License - see LICENSE file for details

Source: README.md at commit 05ac6d5

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.