DigitalOcean MCP Server

This MCP server exposes DigitalOcean App Platform functionality through standardized tools that can be used by any MCP client, including Claude Desktop and Cursor. It enables AI assistants to directly manage your DigitalOcean apps without writing code or memorizing API endpoints.

---

📚 Table of Contents

• 🚀 What Can You Do With It?

• 🧰 Prerequisites

• ⚙️ Setting up your DigitalOcean MCP Server

  • Generate Your API Token
  • Add the Server to Your MCP Client
  • Claude Desktop
  • Cursor
  • Windsurf Setup

• 💬 Example Prompts

• 🛠 Available Tools

• 🧯 Troubleshooting

• 🤝 Contributing

• 📄 License

---

🚀 What Can You Do With It?

You can now do things like:

• Deploy a new app from a GitHub repo
• Quickly redeploy an existing app with the latest changes
• See logs, restart components, or delete old environments
• Check available regions and create apps based on what’s supported
• Build and deploy an app from scratch, entirely through your assistant

...and more!

---

🧰 Prerequisites

To use the DigitalOcean MCP Server, you’ll need:

• Node.js (≥ 12) & npm
• A DigitalOcean Personal Access Token with App Platform scopes
• A supported MCP client:
  • Claude Desktop (v1.9+)
  • Claude Code
  • Cursor
  • Windsurf
• (Optional but helpful): GitHub CLI (gh) - useful for cloning repos, creating projects, and working with GitHub-based apps.

💡 You do not need to install anything—this server runs via npx, with just a one-line config added to your MCP client.

---

⚙️ Setting up your DigitalOcean MCP Server

1. Generate Your API Token

Head to DigitalOcean’s API settings and create a new Personal Access Token with App Platform permissions.

2. Add the Server to Your MCP Client

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

{
  "mcpServers": {
    "digitalocean": {
      "command": "npx",
      "args": ["@digitalocean/mcp"],
      "env": {
        "DIGITALOCEAN_API_TOKEN": "YOUR_DO_TOKEN"
      }
    }
  }
}

Here’s what each part of the snippet does:

• • command: how to launch the server (npx or full path)
• • args: the package name
• • env: insert your DO token here

Then follow the instructions for your specific tool:

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

Setting up DigitalOcean MCP Server in Claude Desktop

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.
6. You should now see “digitalocean” in Cursor’s MCP settings

Setting up DigitalOcean MCP Server in Cursor

Windsurf Setup

1. In Windsurf: 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.
6. You should now see “digitalocean” in Windsurf's MCP settings

Setting up DigitalOcean MCP Server in Windsurf

---

💬 Example Prompts

Once it’s configured, try asking your assistant:

“List all active apps on my account”
“Create a new app from https://github.com/do-community/do-one-click-deploy-flask with 1GB RAM in NYC3”
“Show logs for checkout-service”
“Cancel the current deployment for marketing-site”
“Delete the old `staging-env` app”

The assistant will send the request → the MCP server talks to DigitalOcean → you get structured results, ready to act on.

---

Available Tools

Category	Commands
Apps	list_apps, create_app, get_app, update_app, delete_app, restart_app
Deployments	list_deployments, create_deployment, get_deployment, cancel_deployment
Logs	retrieve_active_deployment_logs, download_logs
Infra	list_app_regions, list_instance_sizes
Alerts	list_app_alerts, update_app_alert_destinations
Rollbacks	validate_app_rollback, rollback_app, commit_app_rollback, revert_app_rollback
Metrics	get_app_bandwidth_daily_metrics, get_all_app_bandwidth_daily_metrics
Validation	validate_app_spec

---

Troubleshooting

The server doesn’t appear in your client?

• Make sure your JSON config is saved and valid
• Restart your MCP client (Claude, Cursor, Windsurf)

Token not working?

• Check that it has App Platform access
• Try generating a fresh one

JSON errors?

• No trailing commas
• No comments allowed in JSON

You can also test the server directly by running:

npx @digitalocean/mcp

---

Contributing

We’d love your help improving this! Bug reports, new features, and docs improvements are all welcome.

1. Fork this repo
2. Create a branch (git checkout -b feature/awesome-tool)
3. Open a PR

---

License

This project is licensed under the MIT License.