gmail

Fetch recent Gmail emails and mark them as read via OAuth2.

19|3|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/samttoo22-MewCat/OpenSoul --skill gmail-samttoo22-mewcat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/samttoo22-MewCat/OpenSoul/tree/main/openclaw/skills/gmail
Command: npx skills add https://github.com/samttoo22-MewCat/OpenSoul --skill gmail-samttoo22-mewcat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-auth-oauthlib, google-auth-httplib2, google-api-python-client, and includes scripts (resource) components.

What problem does it solve?

This Skill streamlines your email management by securely accessing your Gmail account, allowing you to fetch recent emails, and automatically mark them as read, saving you time and effort.

Core Features & Use Cases

  • Secure OAuth2 Authentication: Uses Google's standard OAuth2 flow for safe access without needing app passwords.
  • Recent Email Retrieval: Fetches emails from the last 3 days, including both read and unread messages.
  • Automatic Read Marking: Automatically marks fetched emails as read to keep your inbox organized.
  • Multi-language Support: Handles various character encodings like UTF-8, Big5, and GBK.
  • Local Caching: Caches up to 50 emails locally for faster access.
  • Use Case: Automatically fetch and summarize the latest 5 emails from your inbox every hour to stay updated without manual checking.

Quick Start

Fetch the latest 10 emails from your Gmail account.

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I automate fetching recent Gmail emails using OAuth2?

Automate Gmail email fetching by configuring Google OAuth2 API credentials to securely read recent inbox messages. This integration fetches emails from the last 3 days and automatically marks them as read for streamlined inbox management.

Do I need app passwords to manage my Gmail inbox automatically?

No, you do not need app passwords to manage your Gmail inbox automatically. Secure access is handled entirely through Google's standard OAuth2 authentication flow using Google Cloud project credentials and a valid OAuth2 token.

How to retrieve and cache Gmail inbox messages locally using Python?

Retrieve and cache Gmail inbox messages locally by using the Google API Python Client to fetch recent emails. The process caches up to 50 messages locally, ensuring faster subsequent access to your recent inbox data.

Does this Gmail OAuth2 integration support multi-language character encodings?

Yes, this Gmail OAuth2 integration supports multi-language character encodings. It automatically handles various text encodings including UTF-8, Big5, and GBK when fetching and processing your recent emails.

What are the limitations of local caching for Gmail inbox management?

The limitation of local caching for Gmail inbox management is a maximum capacity of 50 messages. Additionally, the retrieval mechanism is restricted to fetching emails received within the last 3 days.

Can I automatically mark fetched Gmail emails as read?

Yes, you can automatically mark fetched Gmail emails as read. The integration automatically updates the read status of retrieved messages to help keep your Gmail inbox organized without manual intervention.