Dome Systems
Dashboard
DocsLearnHands-on LabsTemplatesHelpChangelogCLIAPIMCPSDKs

Ask questions about Dropbox

A read-only managed agent for searching Dropbox content.

User
Caller
  • chat
App
Agent
  • dropbox-answerer
Governance
Gateway
  • dropbox-readonly
Pool

dropbox-answerer-pool

  • dropbox-answerer-model
Tools

dropbox

    What this template gives you

    • Interface

      A chat window, in your browser

      Use the included interface to send a request to this template.

    • Gateway

      dropbox-readonly gateway

      This template sends its requests through dropbox-readonly gateway, where its access rules and limits apply.

    • Model

      dropbox-answerer-model

      This template uses dropbox-answerer-model through the dropbox-answerer-pool pool.

    Usage

    Hand this template to an AI agent to set up this template

    Node.js and npm to run npx.

    Dome CLI, installed with brew install dome-systems/tap/dome, then signed in with dome auth login.

    Docker Compose to run the companion app locally.

    1. 1

      Create a workspace

      dome workspaces create --name <workspace-name>

      The CLI creates and selects a workspace context for you.

    2. 2

      Confirm the workspace context

      dome context list

      The workspace you just created is already selected.

    3. 3

      Pull the template

      npx @domesystems/templates pull dome-systems/ai-agent-for-dropbox@0.1.1 --dir ai-agent-for-dropbox

      Downloads this immutable release and verifies its digest.

    4. 4

      Run the template

      npx @domesystems/templates up --dir ai-agent-for-dropbox

      Imports it into Dome and starts the companion app.

    Dome import variables

    npx @domesystems/templates up imports the template into Dome and prompts for required values. For unattended runs, set them as DOME_IMPORT_VAR_… environment variables.

    Required values

    • DOME_IMPORT_VAR_anthropic_api_key
    • DOME_IMPORT_VAR_dropbox_oauth_client_id
    • DOME_IMPORT_VAR_dropbox_oauth_client_secret

    Setup guide

    Follow this template's setup guidance for agent variables and upstream connections.

    # Configure Dropbox

Dropbox only enables Dynamic Client Registration for a limited set of MCP clients. To use this template with Dome, register a Dropbox app and connect it with that app's OAuth credentials.

- `anthropic_api_key`: enter the Anthropic key used by this agent's model.
- `dropbox_oauth_client_id`: enter the Dropbox app key from the app's **Settings** page.
- `dropbox_oauth_client_secret`: enter the Dropbox app secret from the same page.

Set up the Dropbox app before importing:

- In the [Dropbox App Console](https://www.dropbox.com/developers/apps), create a **Scoped access** app with the smallest content access area that contains the files the agent should inspect.
- In **Permissions**, enable only the read scopes the agent needs, normally `files.metadata.read`, `files.content.read`, `sharing.read`, and `account_info.read`. Do not enable write, move, delete, or sharing-management scopes for this read-only agent.
- In **Settings**, add `https://api.domesystems.ai/oauth/callback` as an OAuth 2 redirect URI, then copy the app key and app secret into the template inputs above.
- Import the template and complete Dropbox authorization with a test account restricted to the intended files. On Dropbox's consent screen, review the requested access and change the selected permissions if Dropbox offers that option.

For Dropbox Business, have an administrator approve the app first. See [Dropbox's MCP setup guide](https://help.dropbox.com/integrations/connect-dropbox-mcp-server) and [OAuth guide](https://developers.dropbox.com/oauth-guide) for current app and permission requirements.

    Runtime environment

    These variables are required to run the agent. During pull, .env.example is copied to .env when available. If they’re missing, npx @domesystems/templates up retrieves them from Dome and saves them in .env. Pass --provision to refresh them.

    No .env.example is included in this release.

    Agent instructions

    Search and summarize files and folders in the connected Dropbox. Do not create,
edit, move, share, or delete Dropbox files, folders, or permissions.