At a glance
- Availability: Experimental (how to enable).
- Auth: OAuth 2.0.
- Connection: A user authorizes the connection in the provider’s consent screen.
- Scopes:
read,write. - Docs: https://docs.digitalocean.com/reference/api/oauth/
Credentials
Set these per environment. See Connect an integration. With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.Setup
- Get a DigitalOcean account: Sign up at https://www.digitalocean.com - new accounts get trial credit you can use for testing.
- Register an OAuth application: Go to API > OAuth Applications (https://cloud.digitalocean.com/account/api/applications), register an app, and set the callback URL to your app’s /api/auth/digitalocean/callback URL.
- Set environment variables: Copy the Client ID and Client Secret into your .env as DIGITALOCEAN_CLIENT_ID and DIGITALOCEAN_CLIENT_SECRET.
- Verify access: Complete the OAuth flow, then run Get Account and List Droplets.
- Scopes are space-separated ‘read write’; request only ‘read’ if you don’t need mutations
- Access tokens expire after 30 days; refresh tokens are single-use and rotate on each refresh
- Creating Droplets provisions billable infrastructure - confirm sizes and regions before running write tools
Tools
| Tool | Access | Description |
|---|---|---|
| List Droplets | Read | List Droplets in the account |
| Get Droplet | Read | Get a Droplet by ID |
| Create Droplet | Write | Create a new Droplet (provisions billable infrastructure) |
| Delete Droplet | Write | Permanently destroy a Droplet by ID |
| List Database Clusters | Read | List managed database clusters in the account |
| Get Account | Read | Get account information and limits for the authenticated user |
Example prompts
- List my DigitalOcean Droplets and database clusters with their status and region.
- Create a small Ubuntu Droplet in the region closest to me, after confirming the size and cost with me.