ArgoCD MCP Server
About
An MCP (Model Context Protocol) server that integrates with the ArgoCD API, enabling agentic tools to manage ArgoCD through natural language interactions.
Details
- License
- MIT
Explore
- 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
- Get detailed application information
- Create, update, and delete applications
- Sync applications with configurable options
- Robust API Client:
- URL normalization and intelligent endpoint handling
- Comprehensive error handling and detailed error messages
- Configurable timeouts and SSL verification
- Token security protection and masking
- Developer Experience:
- Full static type checking with mypy
- Detailed documentation and examples
- Environment-based configuration
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ArgoCD MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
uv venv
source .venv/bin/activate
uv pip install -e .
export ARGOCD_TOKEN=YOUR_ARGOCD_TOKEN
export ARGOCD_API_URL=https://your-argocd-server.com:9000/api/v1
export ARGOCD_VERIFY_SSL=false # Disable SSL verification for self-signed certs
uv run server.py
User: What version of ArgoCD is running on the server?
Claude: Let me check the ArgoCD version information.
⏺ argocd-mcp:get_version (MCP)
⎿ {
"Version": "v2.9.3+5eaf684",
"BuildDate": "2023-09-15T14:25:11Z",
"GitCommit": "5eaf68452",
"GitTreeState": "clean",
"GoVersion": "go1.20.7",
"Compiler": "gc",
"Platform": "linux/amd64",
"KustomizeVersion": "v5.1.1",
"HelmVersion": "v3.12.3",
"KubectlVersion": "v1.27.4",
"JsonnetVersion": "v0.20.0"
}
You're running ArgoCD v2.9.3, built on September 15, 2023. It's running on Linux (amd64) with Go 1.20.7, and includes Kustomize v5.1.1 and Helm v3.12.3.
User: Show me the ArgoCD server settings
Claude: Let me retrieve the ArgoCD server settings for you.
⏺ argocd-mcp:get_settings (MCP)
⎿ {
"clusterSettings": {
"appLabelKey": "argocd.argoproj.io/instance",
"controllerNamespace": "argocd",
"execEnabled": true,
"statusBadgeEnabled": true,
"uiBannerContent": "This is a development instance of ArgoCD",
"url": "https://argocd.example.com"
}
}
Here are the key settings for your ArgoCD server:
- URL: https://argocd.example.com
- Controller namespace: argocd
- Exec enabled: Yes
- Status badge enabled: Yes
- UI Banner: "This is a development instance of ArgoCD"
uv pip install mypy
env | grep ARGOCD
```
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
export ARGOCD_TOKEN=YOUR_ARGOCD_TOKEN
mcp dev server.py
- 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
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"argocd mcp server": {
"argocd-mcp-severity1": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"argocd-mcp-severity1": {
"command": "uv",
"args": [
"venv"
]
}
}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.
<a href="https://glama.ai/mcp/servers/@severity1/argocd-mcp">
</a>
Features
- 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
- Get detailed application information
- Create, update, and delete applications
- Sync applications with configurable options
- Robust API Client:
- URL normalization and intelligent endpoint handling
- Comprehensive error handling and detailed error messages
- Configurable timeouts and SSL verification
- Token security protection and masking
- Developer Experience:
- Full static type checking with mypy
- Detailed documentation and examples
- Environment-based configuration
Quick Start
Setup
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
