DigitalOcean

Let your agents watch and operate your DigitalOcean infrastructure — browse Droplets, reboot, shut down or power them on, read App Platform apps and deployments, trigger a redeploy, check app health, read managed database clusters and their events, manage DNS records, list projects and read the account balance.

Connection

Authentication: API key (DigitalOcean personal access token).

Log in to the DigitalOcean Control Panel → Account → API → Tokens tab → Personal access tokens → Generate New Token. Name it, pick an expiration, then under Scopes choose “Custom Scopes” and tick only what you need: account:read (lets the connection check the token), droplet:read, droplet:update (reboot, shut down, power on), app:read, app:update (trigger a deployment), database:read, domain:read, domain:create (create DNS records), project:read, billing:read (balance), and tag:read if you filter Droplets by tag. Click Generate Token and copy it — it is shown only once. “Read Only” also works for reads; avoid “Full Access”.See DigitalOcean’s documentation.

Read actions (17)

Action	Description
`get_account`	Get the account the token belongs to: uuid, name, email, email_verified, status (active, warning, locked), Droplet and floating IP limits, current team. No argument.
`get_app`	Get one App Platform app: spec (components, domains, ingress), live_url, region, active / in-progress / pending deployment, created_at. Environment variable values, registry credentials and log-destination keys are removed from every spec (variable keys are kept). Required: app_id (string, the id from list_apps or a “do:app:<id>” URN from list_project_resources).
`get_app_health`	Get the health of an App Platform app: per component, cpu_usage_percent, memory_usage_percent, replicas_desired, replicas_ready and state (HEALTHY, UNHEALTHY, UNKNOWN); function components carry their health metrics. Required: app_id (string, the id from list_apps or a “do:app:<id>” URN from list_project_resources).
`get_balance`	Get the account balance: month_to_date_balance, account_balance, month_to_date_usage and generated_at. No argument. Requires billing:read.
`get_database`	Get one managed database cluster: engine, version, status, size, num_nodes, region, storage_size_mib, db_names, maintenance_window, trusted-source rules, connection details (host, port, user, database, ssl) and users (name, role). Passwords, connection URIs and Kafka user keys/certificates are removed. Required: database_cluster_uuid (uuid, see list_databases).
`get_droplet`	Get one Droplet by id (see list_droplets or list_project_resources): status (new, active, off, archive), size, region, image, networks, volume_ids, tags, locked.
`get_droplet_action`	Get the status of an action run on a Droplet (in-progress, completed, errored), with started_at / completed_at. Required: droplet_id (integer), action_id (integer, the action.id returned by reboot_droplet, shutdown_droplet or power_on_droplet).
`list_app_deployments`	List the deployments of an App Platform app, newest first: id, phase (PENDING_BUILD, BUILDING, PENDING_DEPLOY, DEPLOYING, ACTIVE, SUPERSEDED, ERROR, CANCELED), cause, progress (steps, error_steps), created_at, updated_at and the spec deployed. Environment variable values, registry credentials and log-destination keys are removed from each spec. Required: app_id (string, see list_apps). Optional: per_page (integer 1-200), page (integer ≥ 1).
`list_app_instances`	List the running instances of an App Platform app (component name and type, instance name and alias). Required: app_id (string, the id from list_apps or a “do:app:<id>” URN from list_project_resources).
`list_apps`	List App Platform apps: id, spec (name, region, services, static_sites, workers, jobs, functions, databases, domains, ingress), live_url, default_ingress, active_deployment, in_progress_deployment, pending_deployment, created_at, updated_at. Environment variable values, registry credentials and log-destination keys are removed from every spec (variable keys are kept). Optional: with_projects (boolean, adds project_id), per_page (integer 1-200), page (integer ≥ 1).
`list_database_events`	List the event log of a managed database cluster (event id, cluster name, event type, create time). Required: database_cluster_uuid (uuid, see list_databases or a “do:dbaas:<uuid>” URN from list_project_resources).
`list_databases`	List managed database clusters: id (uuid), name, engine, version, status, size, num_nodes, region, db_names, tags, maintenance_window, project_id, connection details (host, port, user, database, ssl) and users (name, role). Passwords, connection URIs and Kafka user keys/certificates are removed. Optional: tag_name (string, requires tag:read).
`list_domain_records`	List the DNS records of a domain (id, type, name, data, priority, port, ttl, weight, flags, tag). Required: domain_name (e.g. “example.com”, see list_domains). Optional: name (fully qualified record name, e.g. “sub.example.com”), type (A, AAAA, CAA, CNAME, MX, NS, SOA, SRV, TXT), per_page (integer 1-200), page (integer ≥ 1).
`list_domains`	List the domains managed by DigitalOcean DNS (name, ttl, zone_file). Optional: per_page (integer 1-200), page (integer ≥ 1).
`list_droplets`	List Droplets (id, name, status, size, region, image, networks, tags). Optional: name (exact name, case-insensitive), type (“droplets” = default, non-GPU \| “gpus”), tag_name (requires tag:read; cannot be combined with name or type), per_page (integer 1-200), page (integer ≥ 1).
`list_project_resources`	List the resources assigned to a project, as URNs: “do:droplet:<droplet id>”, “do:app:<app id>”, “do:dbaas:<database cluster uuid>”, “do:domain:<domain name>”, “do:volume:…”, “do:loadbalancer:…”, “do:kubernetes:…”… — another way to find app ids and database cluster uuids (see also list_apps, list_databases). Required: project_id (uuid from list_projects, or “default” for the default project). Optional: per_page (integer 1-200), page (integer ≥ 1).
`list_projects`	List projects (id, name, purpose, environment, is_default). Optional: per_page (integer 1-200), page (integer ≥ 1).

Write actions (5)

Action	Description
`create_app_deployment`	Trigger a new deployment of an App Platform app from its current spec (redeploy). Arguments: app_id (string, path, see list_apps); force_build (boolean, optional: rebuild from source even if a cached build could be reused). Returns the deployment (follow its phase with list_app_deployments); secrets are removed from its spec. Requires app:update.
`create_domain_record`	Create a DNS record in a domain. Arguments: domain_name (string, path, e.g. “example.com”, see list_domains); type (string: A, AAAA, CAA, CNAME, MX, NS, SRV or TXT); name (string, host name relative to the domain, ”@” for the apex — required except for MX); data (string: IPv4 for A, IPv6 for AAAA, target host for CNAME / MX / NS / SRV, text for TXT, CA domain for CAA); priority (integer, required for MX and SRV); port (integer, required for SRV); weight (integer, SRV only); flags (integer 0-255, required for CAA); tag (string “issue”, “issuewild” or “iodef”, required for CAA); ttl (integer, seconds, optional). Requires domain:create.
`power_on_droplet`	Power on a Droplet that is off. Arguments: droplet_id (integer, path, see list_droplets). Returns an action — follow it with get_droplet_action. Requires droplet:update.
`reboot_droplet`	Gracefully reboot a Droplet (like running reboot from the console). Arguments: droplet_id (integer, path, see list_droplets). Returns an action — follow it with get_droplet_action. Requires droplet:update.
`shutdown_droplet`	Gracefully shut down a Droplet (like running shutdown from the console; the command is issued, success is not guaranteed — check with get_droplet_action and get_droplet). Arguments: droplet_id (integer, path, see list_droplets). Requires droplet:update.

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Last reviewed against the provider API: September 2026.

Using integrations

Communication

Scheduling

Project management

Docs & design

Files & storage

CRM & sales

Customer support

HR & recruiting

Commerce & billing

Developer tools

Observability & analytics

AI & media

DigitalOcean

Connection

Read actions (17)

Write actions (5)

Permissions

​Connection

​Read actions (17)

​Write actions (5)

​Permissions

Connection

Read actions (17)

Write actions (5)

Permissions