← Docs

inbox.dog for Open Claw

Fastest path to Gmail tools for agents. Read/search/send via OAuth. CASA Tier 2 certified. Self-host optional.

At a glance (pick one path)

  • Path A — MCP config (recommended): Use if your OpenClaw version supports mcpServers.
  • Path B — Workspace Skill (compat mode): Use if adding mcpServers fails/invalid config.

Both paths expose the same Gmail tools: get_profile, read_emails, search_emails, read_email, send_email.

Path A: MCP config (recommended)

1) Add MCP server

{
  "mcpServers": {
    "inbox-dog": {
      "url": "https://inbox.dog/mcp"
    }
  }
}

2) Restart gateway

openclaw gateway restart

3) Verify

What's my email address?

If this path fails because mcpServers is unsupported, use Path B below.

Path B: Workspace Skill (compat mode)

1) Create skill folder

mkdir -p ~/.openclaw/workspace/skills/inbox-dog

2) Create API key

curl -s -X POST https://inbox.dog/api/keys \
  -H "Content-Type: application/json" \
  -d '{"name": "openclaw"}' | jq

3) Add credentials

{
  "skills": {
    "entries": {
      "inbox-dog": {
        "enabled": true,
        "env": {
          "INBOXDOG_CLIENT_ID": "id_your_client_id_here",
          "INBOXDOG_CLIENT_SECRET": "sk_your_client_secret_here"
        }
      }
    }
  }
}

4) Restart gateway

openclaw gateway restart

5) Auth without localhost callback

Use a hosted redirect (no localhost 404). Open this URL in your browser:

https://inbox.dog/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=https%3A%2F%2Finbox.dog%2Fconnect%2Foauth&scope=email

After consent, you'll land on a hosted success page with an easy copy button for the one-time code. Paste that code to your OpenClaw agent if it asks.

6) Verify

What's my email address?

Trust notes

  • OAuth flow with PKCE (no Gmail password handling)
  • CASA Tier 2 certified for restricted Gmail scopes
  • Self-host available

Auth behavior (important)

  • OAuth code values are one-time use. Reusing a code will fail.
  • If you complete auth but still can’t read mail, run the verify prompt again: What's my email address?
  • For Workspace Skill installs, prefer hosted redirect URIs (like this docs page), not localhost callbacks.