How to Organize Your Insurance from Gmail with OpenClaw

You have insurance documents in your email going back years. Renewal notices from State Farm. Declaration pages from Allstate. ID cards from USAA. They’re sitting in your inbox right now, unread or buried under hundreds of other messages.

Most people never organize this stuff. The result: you don’t know what you’re actually paying across carriers, what changed at your last renewal, or whether you’re missing discounts. The information exists. It’s just trapped in email.

Here’s how to get it out.

What you’ll build

An OpenClaw agent that:

• Searches your Gmail for insurance-related emails and attachments
• Downloads the policy PDFs
• Uploads each one to Policy Penguin for extraction
• Gets back structured data: carrier, premiums, coverages, vehicles, effective dates

You run it once and your entire insurance portfolio is organized. Every policy, every carrier, every coverage limit. From scattered email attachments to a single structured view.

Prerequisites

• OpenClaw installed and running
• A Gmail account (your real one, where your insurance emails are)
• A Policy Penguin account with an API key

Step 1: Connect OpenClaw to Gmail

The fastest path is gogcli, a Google Workspace CLI from steipete’s ecosystem. It gives OpenClaw access to Gmail, Drive, Calendar, and more.

Install it and add the OpenClaw skill:

brew install gogcli
clawd skill add luccast/gogcli

Set up Google OAuth credentials (one-time):

1. Go to Google Cloud Console
2. Create a project (or use an existing one)
3. Enable the Gmail API
4. Create OAuth credentials (Desktop app type)
5. Download the credentials file

Register and authorize:

gog auth credentials ~/Downloads/client_secret.json
gog auth add your-email@gmail.com

A browser window opens. Sign in with your Google account and grant access. Done.

Alternative: If you prefer managed auth, Composio offers a hosted MCP endpoint that handles OAuth for you. One fewer thing to configure, but adds a third-party dependency.

Step 2: Connect OpenClaw to Policy Penguin

Sign up at policypenguin.ai and grab an API key from your dashboard.

Option A: MCP server (recommended if you want to query your data after upload too)

Add Policy Penguin to your OpenClaw MCP config:

{
  "mcpServers": {
    "policy-penguin": {
      "url": "https://mcp.policypenguin.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

This gives your agent the upload_policy tool plus query tools for asking questions about your coverage later. See the MCP documentation for the full tool list.

Option B: REST API via environment variable

If you prefer direct HTTP calls without MCP:

export POLICY_PENGUIN_API_KEY=pp_live_xxxxx

Your agent can then call the REST API directly. The upload endpoint is POST https://api.policypenguin.ai/v1/upload with the key in the Authorization header.

Either way, your API key stays in config or environment. Never paste it into the chat.

Step 3: Let the agent work

Tell your OpenClaw agent what to do:

The agent searches Gmail using queries like:

• from:statefarm.com has:attachment filename:pdf
• from:allstate.com has:attachment filename:pdf
• subject:(renewal OR declaration OR policy) has:attachment filename:pdf

For each attachment it finds, it downloads the PDF, base64 encodes it, and calls Policy Penguin’s upload API. Each upload returns structured data in about 15 seconds.

Seven emails. Two carriers. Full coverage details with numeric limits. Premium history for trend tracking. All from one conversation.

What you get

Open Policy Penguin and your vault is populated. Every policy organized by carrier, with:

• Coverage limits as numbers (not display strings like “$250K/$500K”)
• Premium history across renewals (so you can see rate creep)
• Linked vehicles and properties
• Missing discount analysis with estimated savings per discount
• Coverage gap detection (like an umbrella requiring higher auto limits than you carry)

The historical policies matter too. With multiple terms from the same carrier, Policy Penguin tracks your premium trajectory. You can see whether your State Farm auto went up 3% or 15% at the last renewal, and how that compares to the state average.

What’s next

Your policies are in the system. Now connect the MCP server so your agent can query your data anytime:

Once your policies are organized, you can query them through your agent at any time. See How to Build an Insurance Agent with OpenClaw and Policy Penguin for the full setup.

You can also re-run the Gmail scan periodically. When a new renewal notice arrives, tell your agent to check for recent insurance emails and upload any new documents. Your portfolio stays current without manual work.

Get started

1. Install OpenClaw and connect your Gmail with gogcli
2. Sign up for Policy Penguin and grab your API key
3. Tell your agent to find your insurance emails
4. Open Policy Penguin and see the full picture

Your policies are already in your inbox. Now they’re structured, searchable, and working for you. Questions? Drop us a line .