skills.rest
QuixiAI
QuixiAIOFFICIAL
Explore all skills by this author →
GitHub

gmail-connector-setup

Guides Gmail connection setup, authorization, backfill, and revocation through structured tool calls.

609|81|Updated Nov 15, 2024
Search Tags:#Authorization#Gmail#backfill#InBox#email integration#connector setup#oAuth
One-click install
npx skills add https://github.com/QuixiAI/Hexis --skill gmail-connector-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail-connector-setup
Source: https://github.com/QuixiAI/Hexis/tree/main/skills/installed/gmail-connector-setup
Command: npx skills add https://github.com/QuixiAI/Hexis --skill gmail-connector-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Connecting Gmail to an AI assistant involves OAuth authorization, capability scoping, memory policy choices, and backfill management, which users often struggle to configure on their own. This Skill turns that into a guided in-chat flow with audited tool calls.

Core Features & Use Cases

  • Guided Connection Flow: Checks setup status, asks about provider powers (read, send/reply, label, spam triage, delete), and walks the user through Google sign-in via a structured setup UI.
  • Privacy-First Configuration: Separately configures whether email reads feed memory (integrations.gmail.memory_policy) and whether autonomous heartbeats may check Gmail (heartbeat_digest_enabled).
  • Backfill & Job Control: Queues read-only email history backfill with scoped queries, monitors progress, and supports pause, resume, or cancel operations.
  • Use Case: A user says "connect my Gmail and let the assistant read my inbox but don't remember anything." The Skill asks the right scoping questions, opens the setup UI, completes authorization, and reports the granted capabilities.

Quick Start

Ask the assistant to connect your Gmail account with read-only access and it will walk you through the setup panel step by step.

Frequently Asked Questions about gmail-connector-setup

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

FAQPage Schema
How do I connect my Gmail account to the assistant?▼

Ask the assistant to connect Gmail and it will check setup status, ask which capabilities you want (read, send, labels, spam triage, delete), then open a structured setup UI with Google sign-in. After you approve, paste the redirected URL or code to complete the connection.

How do I control whether the assistant remembers my emails?▼

Email memory is governed by the Hexis config key integrations.gmail.memory_policy, chosen during setup and separate from Google permissions. You can have email reads forgotten after the task or stored in memory, and backfill ingestion always requires explicit approval.

Can the assistant check Gmail automatically while I am away?▼

Yes, but only if you enable integrations.gmail.heartbeat_digest_enabled during setup. It defaults to off and is never implied by connecting Gmail, so autonomous heartbeat checks require your explicit opt-in.

How do I import my Gmail history into the assistant's memory?▼

After Gmail is connected, ask to ingest email history and the assistant queues a read-only backfill job with a scoped query, label IDs, and message limit. You can monitor progress and pause, resume, or cancel the job at any time.

How do I disconnect Gmail or revoke access?▼

Ask the assistant to disconnect Gmail and it calls revoke_gmail_connection to remove local access. Revocation is only performed after you explicitly request it, and all connection actions are audited through tool calls.

Related Skills

Explore More Personal & Entrepreneur Skills→
Lilac-LabsLilac-Labs
1.7k

google-workspace-setup

Install CLI tooling, provision a Cloud project, enable seven Workspace APIs, and complete OAuth Desktop authorization.

Official
Advanced
beam-ai-teambeam-ai-team

gmail

Automate Gmail operations to read, send, and manage emails via CLI.

Official
Intermediate
fontesgerardsfontesgerards

cos-consolidate-memory

Consolidate weekly memory by promoting learnings, pruning stale facts, and producing a reviewable diff.

Community
Advanced
DevHive1DevHive1
18

ai-secretary

Draft emails, schedule calendar events, and prioritize administrative tasks.

Community
Advanced