Skip to main content
Glama
mcp-server-digitalocean

mcp-server-digitalocean

DigitalOcean MCP Server

PyPI version License: MIT Python 3.10+

A Model Context Protocol server for DigitalOcean cloud infrastructure. Manage Droplets, databases, domains, and more — all through your AI assistant.

What Can You Do With It?

  • Manage Droplets — list, create, get details, and delete Droplets

  • Query Databases — list and inspect managed database clusters

  • Handle Domains — list, create, and delete domain records

  • Explore Infrastructure — browse available regions and Droplet sizes with pricing

  • Check Account — view account info and usage limits

Related MCP server: timeweb-mcp-server

Table of Contents


Prerequisites


Installation

uv tool install mcp-server-digitalocean

Using pip

pip install mcp-server-digitalocean

Setup

1. Generate Your API Token

Go to DigitalOcean API Tokens and create a new Personal Access Token.

2. Add the Server to Your MCP Client

Add this JSON snippet to your client's MCP config file:

{
  "mcpServers": {
    "digitalocean": {
      "command": "uvx",
      "args": ["mcp-server-digitalocean"],
      "env": {
        "DIGITALOCEAN_TOKEN": "YOUR_DO_TOKEN"
      }
    }
  }
}

Then follow the instructions for your specific client:

Claude Desktop

  1. Go to Settings > Developer > Edit Config

  2. Add the snippet above to claude_desktop_config.json

  3. Replace YOUR_DO_TOKEN with your token

  4. Save and restart Claude Desktop

  5. You'll see "digitalocean" listed as an available server

Cursor

  1. Go to Settings > Cursor Settings > MCP > Add a new global MCP server

  2. Cursor will open ~/.cursor/mcp.json

  3. Add the snippet above to this JSON file

  4. Replace YOUR_DO_TOKEN with your token

  5. Save and return to MCP Settings

Windsurf

  1. Go to Settings > Windsurf Settings > Cascade > MCP > Add Server > Add custom server

  2. Windsurf will open ~/.codeium/windsurf/mcp_config.json

  3. Add the snippet above to this JSON file

  4. Replace YOUR_DO_TOKEN with your token

  5. Save and return to MCP Settings

Claude Code

  1. Run in your terminal:

claude mcp add digitalocean -- uvx mcp-server-digitalocean
  1. Set the environment variable:

export DIGITALOCEAN_TOKEN="your-token-here"

Available Tools

Category

Tools

Account

get_account_info

Droplets

list_droplets, get_droplet, create_droplet, delete_droplet

Databases

list_database_clusters, get_database_cluster

Domains

list_domains, create_domain, delete_domain

Infrastructure

list_regions, list_sizes


Example Prompts

Once configured, try asking your assistant:

"List all my Droplets"
"Create a new 1GB Droplet in NYC1 running Ubuntu 24.04"
"Show me all available regions"
"List my database clusters"
"Delete droplet 42"
"What Droplet sizes are available and how much do they cost?"

Development

# Clone the repo
git clone https://github.com/truecallerabreham/mcp-server-digitalocean.git
cd mcp-server-digitalocean

# Install dependencies
uv sync

# Run tests
uv run pytest

# Run linter
uv run ruff check src/ tests/

# Type check
uv run pyright

Troubleshooting

The server doesn't appear in your client?

  • Make sure your JSON config is saved and valid (no trailing commas)

  • Restart your MCP client (Claude, Cursor, Windsurf)

  • Check that uvx is in your PATH

Token not working?

Still having issues?

Test the server directly:

DIGITALOCEAN_TOKEN="your-token" uvx mcp-server-digitalocean

Contributing

Contributions are welcome! Bug reports, new features, and docs improvements are all appreciated.

  1. Fork this repo

  2. Create a branch (git checkout -b feature/my-feature)

  3. Make your changes

  4. Run tests (uv run pytest)

  5. Open a PR


License

This project is licensed under the MIT License.

Available Tools

12 tools
create_domainB
Idempotent

Create a new domain in your account.

Inputs: name (required), ip_address (required).

create_dropletB

Create a new Droplet. Specify name, region, size, and image.

Inputs: name (required), size (required), image (required), region (required), +2 more.

delete_domainB
DestructiveIdempotent

Delete a domain from your account.

Inputs: name (required).

delete_dropletA
DestructiveIdempotent

Permanently delete a Droplet. This action is irreversible.

Inputs: droplet_id (required).

get_accountA
Read-onlyIdempotent

Get your DigitalOcean account information including email, UUID, and account limits.

Inputs: no named parameters.

get_databaseA
Read-onlyIdempotent

Get detailed information about a specific database cluster.

Inputs: database_id (required).

get_dropletA
Read-onlyIdempotent

Get detailed information about a specific Droplet by its ID.

Inputs: droplet_id (required).

list_databasesA
Read-onlyIdempotent

List all database clusters in your account.

Inputs: no named parameters.

list_domainsA
Read-onlyIdempotent

List all domains in your account.

Inputs: no named parameters.

list_dropletsA
Read-onlyIdempotent

List all Droplets in your account. Returns droplet IDs, names, statuses, IPs, regions, and sizes.

Inputs: page, per_page.

list_regionsA
Read-onlyIdempotent

List all available DigitalOcean datacenter regions.

Inputs: no named parameters.

list_sizesA
Read-onlyIdempotent

List all available Droplet sizes with pricing and capability info.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: create, delete, get, list for droplets and domains; get/list for databases; list for regions and sizes; and get_account for account info. No overlap.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case (e.g., create_droplet, list_domains). No mixing of conventions.

    Tool Count5/5

    12 tools is well-scoped for a DigitalOcean API server, covering key resources without being excessive or too few.

    Completeness3/5

    Basic CRUD for droplets and domains is covered, but missing update operations, database creation/deletion, and droplet actions (e.g., power on/off). Notable gaps exist.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      Not graded
      maintenance
      Provides comprehensive access to 471+ DigitalOcean API endpoints, enabling AI assistants to manage cloud infrastructure including droplets, databases, load balancers, DNS, Kubernetes, and other DigitalOcean resources programmatically.
      6
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables managing Sliplane deployments, projects, and application status through natural language, with OAuth or API key auth.
      MIT