Gmail Integration for Openclaw

A comprehensive Gmail integration skill that allows AI agents to securely read, search, send, and organize emails via the MorphixAI proxy.

paul-leo
v0.1.1
Mar 6, 2026
0
1.5k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install gmail-2

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install gmail-2 using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Gmail Integration?

The Gmail skill for Openclaw Skills empowers AI agents to interact directly with the Gmail API through a secure MorphixAI proxy. This integration allows agents to act as a sophisticated personal assistant capable of retrieving profiles, managing labels, and handling the full lifecycle of an email—from drafting and sending new messages to archiving and trashing old ones. By using this skill, developers can build automated workflows that respond to incoming inquiries or monitor specific threads without manual intervention.

Designed for security and ease of use, the skill leverages environment-based authentication and a simplified linking process. It ensures that sensitive email data is handled within a controlled environment, making it a reliable choice for developers building productivity tools or automated customer support systems within the Openclaw Skills ecosystem.

Gmail Integration Use Cases

  • Automating responses to routine client emails or project inquiries.
  • Monitoring inboxes for specific alerts or keywords using advanced search syntax.
  • Organizing unread messages by automatically applying labels or marking them as read.
  • Summarizing high-priority email threads for daily briefings.
  • Bulk cleaning inboxes by trashing messages that meet specific criteria (e.g., older than 30 days).

How Gmail Integration Works

  1. The agent authenticates using a MorphixAI API key provided in the environment configuration.
  2. The user links their Gmail account to the Openclaw Skills environment using the mx_link utility.
  3. The agent utilizes search_messages or list_messages to identify relevant email IDs based on specific filters.
  4. Detailed content for identified emails is retrieved using the get_message action.
  5. The agent performs secondary actions such as send_mail for replies or mark_as_read for status updates.
  6. All requests are proxied through MorphixAI to ensure secure and standardized API communication.

Gmail Integration Setup

To get started with the Gmail skill, follow these installation steps:

  1. Install the required plugin:
openclaw plugins install openclaw-morphixai
  1. Generate an API Key at morphix.app/api-keys.

  2. Configure your environment variable:

export MORPHIXAI_API_KEY="mk_your_key_here"
  1. Link your Gmail account (app ID: gmail) via the MorphixAI dashboard or the CLI tool:
mx_link --app gmail

Gmail Integration Data Schema & Taxonomy

The skill organizes data around the standard Gmail API objects. Below is the primary data structure utilized by Openclaw Skills:

Object Key Fields Description
Profile emailAddress, messagesTotal Basic user account statistics.
Message id, threadId, labelIds Metadata for identifying unique emails and threads.
Content subject, from, to, body The core payload of the email message (plain text format).
Label id, name, type Taxonomy used for organizing the inbox.
Search query Supports Gmail syntax like is:unread or newer_than:7d.

Gmail Integration Advanced Features

  • Support for advanced Gmail search operators (e.g., from:, to:, has:attachment).
  • Secure credential management through the MorphixAI proxy layer.
  • Automated account detection which streamlines multi-tool workflows.
  • Ability to manage system and user-defined labels for complex inbox organization.
  • Support for CC and BCC fields in automated email dispatch.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*