conan-skill-gmail
v1.0.0
Published
Gmail skill for Conan AI — read, send, reply, forward, delete, search emails via Google OAuth
Maintainers
Readme
conan-skill-gmail
Gmail skill for Conan AI — read, send, reply, forward, delete, and search emails.
You: read my latest emails
Conan: Latest 5 INBOX emails:
• [id:18e4a1c3f2b] From: [email protected]
Subject: Q1 Report Review
Date: Sat, 14 Mar 2026 09:00:00 +0200
Preview: Please review the attached Q1 report before Monday's meeting...
You: reply to that email — tell him I'll review it by Sunday
Conan: ✅ Reply sent successfully to [email protected].
You: search for emails from OpenAI
Conan: Search results for "from:openai.com" (newest first): ...Install
conan skill install conan-skill-gmailSetup
1. Create Google OAuth credentials
- Go to Google Cloud Console
- Create a project → Enable Gmail API
- Go to APIs & Services → Credentials → Create Credentials → OAuth 2.0 Client ID
- Application type: Desktop app
- Add redirect URI:
http://localhost:9854/callback - Copy the Client ID and Client Secret
2. Configure Conan
conan config set googleClientId YOUR_CLIENT_ID
conan config set googleClientSecret YOUR_CLIENT_SECRET3. Connect your Gmail account
conan-gmail-authThis opens your browser for Google sign-in. After approving, your Gmail is connected and tokens are saved locally in ~/.conan/config.json.
Actions
| Action | What it does |
|---|---|
| read | Fetch recent emails from inbox/sent/spam |
| send | Compose and send a new email |
| reply | Reply to an email — stays in the same thread |
| forward | Forward an email to a new recipient |
| delete | Move email to Trash (recoverable for 30 days) |
| search | Search with Gmail query syntax |
Usage
Just ask naturally — Conan picks the right action:
"read my latest 10 emails"
"any emails from [email protected]?"
"send an email to [email protected] about the meeting tomorrow"
"reply to the last email from my boss"
"forward the invoice email to [email protected]"
"delete that spam email"
"search for emails with subject invoice from last month"Search syntax
Conan supports Gmail's full query syntax:
from:[email protected]
subject:invoice
after:2026/01/01
before:2026/03/01
has:attachment
label:importantPrivacy
- Tokens stored locally in
~/.conan/config.json - Email content sent only to your configured LLM (OpenAI / Anthropic / OpenRouter)
- Nothing stored on any external server
License
MIT · Amr Lotfy
