Skip to content
Orivra
← Back to OrivraGETTING STARTED

Start with
MailWeave.

Connect Orivra to Gmail through MailWeave. The simpler desktop setup and advanced, self-managed route use the same read-only tools. Choose how much of the setup you want to own.

01 / DESKTOPSIMPLER SETUP

For Claude Desktop.

Connect your own Gmail account without Terminal commands or your own Google Cloud project.

  • Apple Silicon Mac · macOS 14 or later
  • Claude Desktop with local extensions enabled
  • Internet connection for setup and Gmail access
  • 346 MB download · about 1.16 GB unpacked + 1.27 GB of models, plus temporary installation space
  1. Download and install the .mcpb file.In Claude Desktop, open Settings → Extensions → Advanced settings → Install Extension… and choose the downloaded file. The source ZIP is not the installer.
  2. Send “Set up Orivra” in a new chat.Setup prepares the local models and gives you a Google authorization link.
  3. Choose your account and consent.Open the link on the same Mac. Review the read-only permission before granting it.
  4. Return to Claude to finish.Send “Continue the Orivra setup.” Wait for “Orivra is ready” and confirm the account before asking about your mail.
Download MailWeave beta

0.2.0-beta.1 · .mcpb · 346 MB · Apple Silicon only
SHA-256 checksum · Full install & removal guide
No Google approval or endorsement is claimed. If authorization is blocked, stop and contact support; do not disable protections.

02 / SELF-MANAGEDADVANCED

Your project.
Your credentials.

Build and run from the public MIT-licensed source with your own Google Cloud project. This route remains available alongside the desktop package.

  • Comfortable using a terminal
  • Python 3.12 and uv
  • Your own Google Cloud project and Gmail API setup
  • A Desktop-app OAuth client that you manage
  1. Get the released source.Follow the matching version’s setup guide, not commands copied from a different release.
  2. Configure Google authorization.Enable Gmail access and create your own Desktop-app OAuth client.
  3. Install and authorize locally.Provision the local models and grant gmail.readonly for the account you choose.
  4. Connect the MCP server.Add Orivra to Claude Desktop using the guide’s command and paths.
Open the self-managed setup guide ↗

View source on GitHub · MIT License
Your Google project’s authorization rules still apply. Self-managed setup is not a bypass for Google’s requirements.

BEFORE YOU GRANT ACCESS

A small permission.
An important choice.

Orivra’s Gmail permission is gmail.readonly. It can read messages and supported attachments, but cannot send, delete or modify your mail.

The evidence it returns becomes available to Claude. Only connect an account you are authorized to use with your AI client, and check your workplace’s data policies first.

Understand storage, sharing and revocation →

Need a hand?

Email kanaparthinayan@gmail.com. Include the setup step and error message, but never your Google tokens, credential files or private email content.