Cohesity DataProtect MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone git@github.com:fredriksknese/mcp-cohesity.git
cd mcp-cohesity
npm install
npm run build
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "COHESITY_CLUSTER=${COHESITY_CLUSTER}" -e "COHESITY_USERNAME=${COHESITY_USERNAME}" -e "COHESITY_PASSWORD=${COHESITY_PASSWORD}" mcp-cohesity -- node "<FULL_PATH_TO_MCP_COHESITY>/dist/index.js"

Replace <FULL_PATH_TO_MCP_COHESITY>/dist/index.js with the actual folder you prepared in step 1.

Required:COHESITY_CLUSTERCOHESITY_USERNAMECOHESITY_PASSWORD+ 2 optional
README.md

Manage backups, recovery operations, and data protection via Cohesity REST API

mcp-cohesity

A Model Context Protocol (MCP) server for Cohesity DataProtect, providing AI assistants with full access to backup management, recovery operations, and data protection monitoring through the Cohesity REST API.

Features

14 tools across six categories:

Cluster

Tool Description
get_cluster_info Get cluster name, ID, software version, and node count
get_cluster_stats Get storage capacity (used/total) and throughput statistics

Protection Policies & Groups

Tool Description
list_protection_policies List all data protection policies with schedule and retention settings
list_protection_groups List protection groups (backup jobs) with status, schedule, and last run info
get_protection_group Get detailed configuration of a specific protection group
run_protection_group Trigger an on-demand backup run for a protection group

Backup Runs

Tool Description
list_protection_runs List recent backup runs with status, duration, and data size
get_protection_run Get detailed information about a specific backup run

Protection Sources

Tool Description
list_sources List all registered sources (vSphere, Physical, NAS, SQL, etc.)
get_source Get full object hierarchy details for a specific source

Recovery

Tool Description
list_recovery_tasks List recovery tasks with status and type
get_recovery_task Get detailed information about a specific recovery task

Alerts

Tool Description
list_alerts List cluster alerts filtered by severity, category, and state
resolve_alert Mark an alert as resolved with resolution notes

Installation

git clone git@github.com:fredriksknese/mcp-cohesity.git
cd mcp-cohesity
npm install
npm run build

Configuration

The server is configured via environment variables:

Variable Required Default Description
COHESITY_CLUSTER Yes — Cohesity cluster hostname or IP address
COHESITY_USERNAME Yes — Username for authentication
COHESITY_PASSWORD Yes — Password for authentication
COHESITY_DOMAIN No LOCAL Authentication domain
COHESITY_ALLOW_SELF_SIGNED No true Accept self-signed SSL certificates

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cohesity": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-cohesity/dist/index.js"],
      "env": {
        "COHESITY_CLUSTER": "your-cohesity-cluster.example.com",
        "COHESITY_USERNAME": "admin",
        "COHESITY_PASSWORD": "your-password",
        "COHESITY_DOMAIN": "LOCAL"
      }
    }
  }
}

Usage with Claude Code

Add to your Claude Code MCP settings:

claude mcp add cohesity -- node /absolute/path/to/mcp-cohesity/dist/index.js

Set the required environment variables before running, or configure them in your MCP settings.

Example Prompts

Once connected, you can ask your AI assistant things like:

  • "Show me the current cluster storage utilization"
  • "List all protection groups that failed their last backup"
  • "Trigger an on-demand backup for the VM production group"
  • "What are the critical alerts on the cluster right now?"
  • "Show me all backup runs in the last 24 hours"
  • "List all VMware protection sources registered on the cluster"
  • "Get the details of the last backup run for protection group ID 12345"
  • "Resolve alert ID abc123 — disk was replaced"
  • "What recovery tasks are currently running?"
  • "List all protection policies and their retention settings"

Development

npm run dev      # Run with tsx (auto-reloads)
npm run build    # Compile TypeScript to dist/
npm start        # Run compiled output

Architecture

src/
├── index.ts              # Entry point — creates MCP server + STDIO transport
├── cohesity-client.ts    # HTTP client with token-based auth and V1/V2 API support
└── tools/
    ├── cluster.ts        # Cluster info and stats (2 tools)
    ├── protection.ts     # Protection policies and groups (4 tools)
    ├── runs.ts           # Backup run management (2 tools)
    ├── sources.ts        # Protection source management (2 tools)
    ├── recovery.ts       # Recovery task management (2 tools)
    └── alerts.ts         # Alert management (2 tools)

API Details

This server uses two Cohesity API versions:

  • V2 API (/v2/) — Used for protection groups, runs, sources, and recoveries
  • V1 API (/irisservices/api/v1/public/) — Used for alerts and source hierarchy

Authentication uses the V2 sessions endpoint (POST /v2/users/sessions) with Bearer token auth. Tokens are automatically refres

Tools (14)

get_cluster_infoGet cluster name, ID, software version, and node count
get_cluster_statsGet storage capacity (used/total) and throughput statistics
list_protection_policiesList all data protection policies with schedule and retention settings
list_protection_groupsList protection groups (backup jobs) with status, schedule, and last run info
get_protection_groupGet detailed configuration of a specific protection group
run_protection_groupTrigger an on-demand backup run for a protection group
list_protection_runsList recent backup runs with status, duration, and data size
get_protection_runGet detailed information about a specific backup run
list_sourcesList all registered sources (vSphere, Physical, NAS, SQL, etc.)
get_sourceGet full object hierarchy details for a specific source
list_recovery_tasksList recovery tasks with status and type
get_recovery_taskGet detailed information about a specific recovery task
list_alertsList cluster alerts filtered by severity, category, and state
resolve_alertMark an alert as resolved with resolution notes

Environment Variables

COHESITY_CLUSTERrequiredCohesity cluster hostname or IP address
COHESITY_USERNAMErequiredUsername for authentication
COHESITY_PASSWORDrequiredPassword for authentication
COHESITY_DOMAINAuthentication domain
COHESITY_ALLOW_SELF_SIGNEDAccept self-signed SSL certificates

Configuration

claude_desktop_config.json
{"mcpServers": {"cohesity": {"command": "node", "args": ["/absolute/path/to/mcp-cohesity/dist/index.js"], "env": {"COHESITY_CLUSTER": "your-cohesity-cluster.example.com", "COHESITY_USERNAME": "admin", "COHESITY_PASSWORD": "your-password", "COHESITY_DOMAIN": "LOCAL"}}}}

Try it

→Show me the current cluster storage utilization
→List all protection groups that failed their last backup
→Trigger an on-demand backup for the VM production group
→What are the critical alerts on the cluster right now?
→Show me all backup runs in the last 24 hours

Frequently Asked Questions

What are the key features of Cohesity DataProtect?

Full access to backup management and recovery operations. Real-time monitoring of cluster health and storage statistics. Comprehensive alert management including resolution capabilities. Support for protection policy and group configuration management. Integration with Cohesity V1 and V2 APIs.

What can I use Cohesity DataProtect for?

Automating on-demand backups for critical production workloads. Monitoring cluster storage capacity and throughput via natural language. Quickly identifying and resolving backup failures or system alerts. Auditing protection policies and retention settings across the cluster.

How do I install Cohesity DataProtect?

Install Cohesity DataProtect by running: git clone git@github.com:fredriksknese/mcp-cohesity.git && cd mcp-cohesity && npm install && npm run build

What MCP clients work with Cohesity DataProtect?

Cohesity DataProtect works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Cohesity DataProtect docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all monitoring servers →

Related MCP Servers

Skylos
Find dead code, secrets, and exploitable flows in Python, TypeScript, and Go.
monitoring344 stars
Linux MCP Server
Read-only Linux system administration and diagnostics on RHEL-based systems.
monitoring189 stars
Charles MCP Server
Integrates Charles Proxy with MCP clients for real-time network traffic analysis
monitoring118 stars
HomeButler
All-in-one homelab management MCP server.
monitoring64 stars
Wireshark MCP
Give your AI assistant a packet analyzer.
monitoring55 stars
RenderDoc MCP
Analyze GPU frame captures for graphics debugging and performance analysis.
monitoring42 stars