Skip to content
MCP server

CloudAlly MCP

Restore or download CloudAlly mailboxes as of a past date, and find failing backups

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.5
Listing updated
4 days ago

About CloudAlly MCP

CloudAlly MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add cloudally-mcp --env CLOUDALLY_CLIENT_ID='<CLOUDALLY_CLIENT_ID>' --env CLOUDALLY_CLIENT_SECRET='<CLOUDALLY_CLIENT_SECRET>' --env CLOUDALLY_ACCESS_TOKEN='<CLOUDALLY_ACCESS_TOKEN>' --env CLOUDALLY_PASSWORD='<CLOUDALLY_PASSWORD>' --env CLOUDALLY_PARTNER_PASSWORD='<CLOUDALLY_PARTNER_PASSWORD>' --env CLOUDALLY_MCP_HTTP_TOKEN='<CLOUDALLY_MCP_HTTP_TOKEN>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/cloudally-v0.2.5/cloudally-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cloudally-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/cloudally-v0.2.5/cloudally-mcp.mcpb"
      ],
      "env": {
        "CLOUDALLY_CLIENT_ID": "<CLOUDALLY_CLIENT_ID>",
        "CLOUDALLY_CLIENT_SECRET": "<CLOUDALLY_CLIENT_SECRET>",
        "CLOUDALLY_ACCESS_TOKEN": "<CLOUDALLY_ACCESS_TOKEN>",
        "CLOUDALLY_PASSWORD": "<CLOUDALLY_PASSWORD>",
        "CLOUDALLY_PARTNER_PASSWORD": "<CLOUDALLY_PARTNER_PASSWORD>",
        "CLOUDALLY_MCP_HTTP_TOKEN": "<CLOUDALLY_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cloudally-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/cloudally-v0.2.5/cloudally-mcp.mcpb"
      ],
      "env": {
        "CLOUDALLY_CLIENT_ID": "<CLOUDALLY_CLIENT_ID>",
        "CLOUDALLY_CLIENT_SECRET": "<CLOUDALLY_CLIENT_SECRET>",
        "CLOUDALLY_ACCESS_TOKEN": "<CLOUDALLY_ACCESS_TOKEN>",
        "CLOUDALLY_PASSWORD": "<CLOUDALLY_PASSWORD>",
        "CLOUDALLY_PARTNER_PASSWORD": "<CLOUDALLY_PARTNER_PASSWORD>",
        "CLOUDALLY_MCP_HTTP_TOKEN": "<CLOUDALLY_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "cloudally-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/cloudally-v0.2.5/cloudally-mcp.mcpb"
      ],
      "env": {
        "CLOUDALLY_CLIENT_ID": "<CLOUDALLY_CLIENT_ID>",
        "CLOUDALLY_CLIENT_SECRET": "<CLOUDALLY_CLIENT_SECRET>",
        "CLOUDALLY_ACCESS_TOKEN": "<CLOUDALLY_ACCESS_TOKEN>",
        "CLOUDALLY_PASSWORD": "<CLOUDALLY_PASSWORD>",
        "CLOUDALLY_PARTNER_PASSWORD": "<CLOUDALLY_PARTNER_PASSWORD>",
        "CLOUDALLY_MCP_HTTP_TOKEN": "<CLOUDALLY_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cloudally-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/cloudally-v0.2.5/cloudally-mcp.mcpb"
      ],
      "env": {
        "CLOUDALLY_CLIENT_ID": "<CLOUDALLY_CLIENT_ID>",
        "CLOUDALLY_CLIENT_SECRET": "<CLOUDALLY_CLIENT_SECRET>",
        "CLOUDALLY_ACCESS_TOKEN": "<CLOUDALLY_ACCESS_TOKEN>",
        "CLOUDALLY_PASSWORD": "<CLOUDALLY_PASSWORD>",
        "CLOUDALLY_PARTNER_PASSWORD": "<CLOUDALLY_PARTNER_PASSWORD>",
        "CLOUDALLY_MCP_HTTP_TOKEN": "<CLOUDALLY_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "cloudally-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/cloudally-v0.2.5/cloudally-mcp.mcpb"
      ],
      "env": {
        "CLOUDALLY_CLIENT_ID": "<CLOUDALLY_CLIENT_ID>",
        "CLOUDALLY_CLIENT_SECRET": "<CLOUDALLY_CLIENT_SECRET>",
        "CLOUDALLY_ACCESS_TOKEN": "<CLOUDALLY_ACCESS_TOKEN>",
        "CLOUDALLY_PASSWORD": "<CLOUDALLY_PASSWORD>",
        "CLOUDALLY_PARTNER_PASSWORD": "<CLOUDALLY_PARTNER_PASSWORD>",
        "CLOUDALLY_MCP_HTTP_TOKEN": "<CLOUDALLY_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Configuration

  • CLOUDALLY_CLIENT_IDThe client-id of your CloudAlly API application (partner portal > Integrations > REST API), sent as the client-id header on every request.Required
  • CLOUDALLY_CLIENT_SECRETThe client-secret of the same API application, sent as the client-secret header on every request.Required
  • CLOUDALLY_ACCESS_TOKENOptional override; leave blank. Run `cloudally-cli auth login --partner` (or `auth login` for one company) in a terminal instead, which saves and refreshes the token. A pasted token expires and keeps overriding the saved one.
  • CLOUDALLY_EMAILOptional. Company account login used by `auth login`; every command is then limited to that one company. Most operators run `auth login` once in a terminal and leave this blank.
  • CLOUDALLY_PASSWORDOptional. Password for the company account login above.
  • CLOUDALLY_PARTNER_EMAILOptional. Partner portal login used by `auth login --partner`; it reaches every customer account and is needed for the distributor and reseller commands, `auth use-account`, past backup dates and downloads.
  • CLOUDALLY_PARTNER_PASSWORDOptional. Password for the partner portal login above.
  • CLOUDALLY_BASE_URLOptional; leave blank. Sends every CloudAlly API call to this base URL instead of https://api.cloudally.com, for tests and mock servers.
  • CLOUDALLY_PORTAL_URLOptional; leave blank. The customer portal origin used for past backup dates, restores resolved from them and downloads (default https://app.cloudally.com). It must be https (plain http only on a loopback test host), and portal credentials go only to https://app.cloudally.com or the CLOUDALLY_BASE_URL origin, so any other portal is refused before anything is sent. Needed when CLOUDALLY_BASE_URL points away from api.cloudally.com: portal commands then refuse to assume the production portal.
  • CLOUDALLY_MCP_READ_ONLYOptional. Set to 1 to list only read-only tools: it removes cloudally_execute, restore_submit, download_submit, download_start, download_link, sync, export, workflow_archive, jobs_prune and the learn-store writers, and cloudally_read refuses every state-changing endpoint. The tools it keeps can still write the learn journal and create an empty local store.
  • CLOUDALLY_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of API responses: reads go to the API, the response cache is off, and sync refuses to run. Leave blank to keep the local store.
  • CLOUDALLY_MCP_HTTP_TOKENRequired only when running the MCP server with --transport http (a remote/hosted deployment); callers must send a matching Authorization: Bearer header. Leave blank for Claude Desktop.
  • CLOUDALLY_USER_AGENTOptional. Overrides the User-Agent the CLI sends to CloudAlly. Leave blank to use the built-in one.
  • PRINTING_PRESS_CLIENT_PROFILEOnly used when the MCP server is bound to a tenant-gated client profile. This connector registers no tenant-gated source, so leave it blank.

Pricing

Open source

CloudAlly MCP FAQ

Is CloudAlly MCP free?

Yes. CloudAlly MCP is open source, so you can use and self-host it for free.

How do I add CloudAlly MCP to Claude Code?

Run this command in your terminal: claude mcp add cloudally-mcp --env CLOUDALLY_CLIENT_ID='<CLOUDALLY_CLIENT_ID>' --env CLOUDALLY_CLIENT_SECRET='<CLOUDALLY_CLIENT_SECRET>' --env CLOUDALLY_ACCESS_TOKEN='<CLOUDALLY_ACCESS_TOKEN>' --env CLOUDALLY_PASSWORD='<CLOUDALLY_PASSWORD>' --env CLOUDALLY_PARTNER_PASSWORD='<CLOUDALLY_PARTNER_PASSWORD>' --env CLOUDALLY_MCP_HTTP_TOKEN='<CLOUDALLY_MCP_HTTP_TOKEN>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/cloudally-v0.2.5/cloudally-mcp.mcpb