msgvault

Configures msgvault for local Gmail archive access with Google OAuth and Codex MCP registration.

1|1|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/powerset-co/powerpacks --skill msgvault-powerset-co
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: msgvault
Source: https://github.com/powerset-co/powerpacks/tree/main/packs/ingestion/skills/msgvault
Command: npx skills add https://github.com/powerset-co/powerpacks --skill msgvault-powerset-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up local Gmail archive access requires creating a Google OAuth Desktop app, configuring client secrets, authorizing accounts, and registering an MCP server, which is a multi-step manual process prone to errors. ## Core Features & Use Cases - Guided OAuth App Creation: Automates Google OAuth Desktop client creation through browser-assisted setup, producing a client named local-msg-vault. - Account Authorization & Status: Checks msgvault readiness, authorizes Gmail accounts (including headless machines), and manages OAuth test users. - Codex MCP Registration: Installs the msgvault MCP server so Codex can search the local Gmail archive after a restart. - Use Case: A recruiter wants to search their Gmail locally through their coding agent. They run $msgvault setup, authorize their account, install the MCP, and start querying their mail archive. ## Quick Start Ask your agent to run msgvault setup with your Gmail address to create the OAuth app, authorize the account, and install the MCP server.

Frequently Asked Questions about msgvault

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up local Gmail archive access with msgvault?▼

Run the msgvault setup command with your Gmail address to create the Google OAuth Desktop app through browser-assisted automation, then run add-account to authorize the Gmail account. Finally run mcp-install and restart Codex to load the MCP server.

How do I create a Google OAuth app for msgvault?▼

Use the browser-setup command for automated creation in Chrome, or create-oauth-app for a manual flow. The OAuth Desktop client is named local-msg-vault, and the downloaded client_secret JSON is configured automatically.

Can I authorize a Gmail account on a headless machine?▼

Yes, add the --headless flag when running the add-account command. This supports authorization flows on machines without a browser, such as remote servers or containers.

What happens if I rerun msgvault browser-setup?▼

The browser-setup command skips Google Console automation when a valid local client secret is already configured. Use --force-browser-setup only when intentionally creating or replacing the OAuth client.

Does msgvault store my Gmail data locally?▼

Yes, msgvault stores and searches Gmail message data locally on your machine. The setup flow makes this clear before starting a sync, and client secret values or token paths are never printed beyond the configured JSON file path.