Status: [UNTESTED] Endpoints found: http://127.0.0.1:3000/gmail/v1/accounts Source: https://github.com/encero/gmail-agent-proxy # Gmail Agent Proxy A deny-by-default Gmail API compatibility layer for a local agent. It can read mail and attachments, search, manage custom labels, and toggle only the `STARRED` and `IMPORTANT` system labels. Sending, drafting, trashing, archiving, marking read/unread, spam actions, forwarding, settings changes, and every unlisted mutation return `403` without being sent to Google. ## Trust boundary Google requires the broad `gmail.modify` OAuth scope to apply labels to messages. The proxy's allowlist prevents use of that scope through its API, but a stolen decrypted refresh token could be used directly against Google. Keep the data volume, encryption key, admin token, and container host trusted. Email content is untrusted input to your agent and can contain prompt injection; the proxy controls mailbox permissions, not model behavior. ## Start Prerequisites: Docker Compose and OpenSSL. ```sh chmod +x scripts/generate-secrets.sh ./scripts/generate-secrets.sh docker compose up --build -d ``` Every push to `main` is also built for `linux/amd64` and `linux/arm64` by GitHub Actions and published as `ghcr.io/encero/gmail-agent-proxy:latest`. Version tags such as `v1.2.3` additionally publish `1.2.3` and `1.2` image tags. Pull requests build and test the image without publishing it. ```sh docker pull ghcr.io/encero/gmail-agent-proxy:latest ``` Open `http://127.0.0.1:3000/admin`, sign in with `secrets/admin_token`, and follow the page: 1. In a Google Cloud project, enable the Gmail API and configure the OAuth consent screen. 2. Create an OAuth 2.0 Web application client. 3. Add `http://127.0.0.1:3000/admin/oauth/callback` as an authorized redirect URI (or the exact `PUBLIC_BASE_URL` equivalent). 4. Upload the downloaded client JSON in the admin page, then link each personal or Workspace account. Workspace administrators may need to approve the app or requested scope. For external apps in testing mode, add each account as a test user. Google may expire refresh