OpenHuman Guide
OpenHuman Guide

Integration Guide

OpenHuman Gmail Integration Guide — Let AI Read Your Emails

2026-05-25~6 min read

OpenHuman's Gmail integration lets your AI assistant read, search, and summarize your emails. Once connected, everything flows into the Memory Tree — making your AI aware of conversations, deadlines, and important messages.

What You Get

  • Auto-sync — new emails are automatically fetched and added to context
  • Semantic search — ask "what did Alice say about the project?" and get the answer
  • Summarization — "summarize today's important emails" works out of the box
  • Memory integration — contacts and projects mentioned in emails enrich your Memory Tree

Setting Up Gmail Integration

OpenHuman uses OAuth 2.0 to connect to your Gmail account. No password sharing — just a secure authorization flow.

Step 1: Open Settings

Open OpenHuman, click the gear icon in the bottom-left corner, then navigate to Integrations → Gmail.

Step 2: Click "Connect Gmail"

A browser window opens asking you to authorize OpenHuman. Click "Allow" to grant read-only access to your Gmail account.

Step 3: Confirm Connection

Once authorized, the browser window closes automatically. You'll see a green "Connected" badge in the integrations panel.

Configuration Options

After connecting, you can fine-tune how OpenHuman handles your email in config.toml:

[integrations.gmail] enabled = true sync_interval_minutes = 15 max_emails_per_sync = 50 include_labels = ["INBOX", "IMPORTANT"] exclude_labels = ["SPAM", "TRASH"] summarize_new = true

Privacy Notes

  • All emails stay local — they are fetched and stored on your machine
  • Only metadata (subject, sender, body text) is stored in Memory Tree
  • Attachments are not downloaded unless you explicitly ask
  • You can revoke access anytime from Google's Connected Apps page

Troubleshooting

Connection fails

Make sure you're logged into the correct Google account. Try disabling any ad-blockers or VPNs during the OAuth flow.

Emails not syncing

Check that sync_interval_minutes is set to a reasonable value. If you have a very large inbox, try reducing max_emails_per_sync.