What makes gogcli-mcp-gmail notable?

3.2K downloads. Trust evidence available

How should gogcli-mcp-gmail be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

gogcli-mcp-gmail

Use when the user asks to read, organize, draft, forward, autoreply, or otherwise work with Gmail in depth. Triggers for requests involving threads, labels, drafts, attachments, bulk archive/trash/mark-read operations, forwarding messages, or any Gmail operation beyond simple search/get/send. Includes auth and Gmail tools only.

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

3.2k

Updated

Oct 9, 2026

Version

4.7.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 3.2K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 3.2K downloadsadoption · observed Oct 9, 2026
Latest release: 4.7.0release · observed Oct 7, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17cjx1a349nz5apaqp02vgz4h85728z:gogcli-mcp-gmail

Install using `clawhub skill install s17cjx1a349nz5apaqp02vgz4h85728z:gogcli-mcp-gmail` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/chrischall/gogcli-mcp-gmail before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-gogcli-mcp-gmail/snapshot"

Documentation

CLAWHUB

158,102 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: gogcli-mcp-gmail
description: Use when the user asks to read, organize, draft, forward, autoreply, or otherwise work with Gmail in depth. Triggers for requests involving threads, labels, drafts, attachments, bulk archive/trash/mark-read operations, forwarding messages, or any Gmail operation beyond simple search/get/send. Includes auth and Gmail tools only.
---

# gogcli-mcp-gmail

Extended Gmail MCP server via [gogcli](https://github.com/openclaw/gogcli) — 61 tools: 8 auth + 4 base Gmail + 49 extra dedicated Gmail tools.

- **Source:** [github.com/chrischall/gogcli-mcp](https://github.com/chrischall/gogcli-mcp)

## Requirements

- [gogcli](https://github.com/openclaw/gogcli) installed and authenticated
- Node.js 22 or later

## Setup

```json
{
  "mcpServers": {
    "gogcli-gmail": {
      "command": "npx",
      "args": ["-y", "gogcli-mcp-gmail"],
      "env": {
        "GOG_ACCOUNT": "[email protected]"
      }
    }
  }
}
```

## Extra Gmail Tools

### Read
| Tool | What it does |
|------|-------------|
| `gog_gmail_raw` | Raw Gmail API JSON for a message |
| `gog_gmail_attachment` | Download an attachment by `attachmentIndex` (or legacy `attachmentId`) and deliver its contents — inline when within `inlineMaxBytes` (3 MiB default, 10 MiB max — larger values are clamped), else a server-side file path — use `url`/`drive` when hosted (`deliver`: auto/inline/drive/url/off). `deliver="url"` gives a signed link `curl` can fetch with no credential, for an hour — hosted deployments only |
| `gog_gmail_url` | Print web URLs for threads |
| `gog_gmail_history` | List history events since a historyId |
| `gog_gmail_messages_search` | Search individual messages, not threads — one row per message |

### Threads
| Tool | What it does |
|------|-------------|
| `gog_gmail_thread_get` | Get a thread with all messages |
| `gog_gmail_thread_modify` | Modify labels on a thread |
| `gog_gmail_thread_attachments` | List/download all attachments in a thread |

### Labels
| Tool | What it does |
|------|-------------|
| `gog_gmail_labels_list` | List all labels |
| `gog_gmail_labels_get` | Get a label's details and counts |
| `gog_gmail_labels_create` | Create a new label |
| `gog_gmail_labels_rename` | Rename a label |
| `gog_gmail_labels_delete` | Delete a label |
| `gog_gmail_labels_modify` | Modify labels on one or more threads |
| `gog_gmail_labels_style` | Change a label's color or visibility |

### Bulk operations
| Tool | What it does |
|------|-------------|
| `gog_gmail_archive` | Archive by IDs or query |
| `gog_gmail_mark_read` | Mark read by IDs or query |
| `gog_gmail_mark_unread` | Mark unread by IDs or query |
| `gog_gmail_trash` | Trash by IDs or query |
| `gog_gmail_message_modify` | Modify labels on a single message |
| `gog_gmail_batch_delete` | Permanently delete multiple messages |
| `gog_gmail_batch_modify` | Modify labels on multiple messages |

### Drafts
| Tool | What it does |
|------|-------------|
| `gog_gmail_drafts_list` | List

README.md

# gogcli-mcp-gmail

> [!WARNING]
> **AI-developed project.** This codebase was built and is actively maintained by [Claude Code](https://www.anthropic.com/claude). Review all code and tool permissions before use.

Extended Gmail [MCP](https://modelcontextprotocol.io) server via [gogcli](https://github.com/openclaw/gogcli). Includes auth tools plus 49 additional dedicated Gmail tools for threads, labels, drafts, attachments, forwarding, autoreply, and bulk operations.

## Requirements

- [gogcli](https://github.com/openclaw/gogcli) installed and authenticated
- Node.js 22+

```bash
brew install gogcli
gog auth add [email protected] --services gmail
```

## Installation

```bash
npm install -g gogcli-mcp-gmail
```

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "gogcli-gmail": {
      "command": "gogcli-mcp-gmail",
      "env": {
        "GOG_ACCOUNT": "[email protected]"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add gogcli-gmail -- gogcli-mcp-gmail
```

## Extra Gmail Tools (49)

Plus 8 auth tools and 4 base Gmail tools (search, get, send, run) — 61 in all.

### Read

| Tool | Description |
|------|-------------|
| `gog_gmail_raw` | Dump the raw Gmail API JSON for a message (lossless, for scripting) |
| `gog_gmail_attachment` | Download an attachment (by `attachmentIndex`, or the legacy opaque `attachmentId`) and deliver its contents — by default an image inline and anything else as a server-side file path (`deliver`: auto/inline/drive/url/off; `inline` forces bytes within `inlineMaxBytes`, 3 MiB by default and at most 10 MiB — a larger value is clamped, since the hosted runtime caps one result at 14 MiB; `drive` uploads to Google Drive). On a hosted deployment, where that path is unreadable, use `url` or `drive`. `deliver="url"` returns a **signed download link** — fetchable with `curl`, no credential and no Google session, valid for an hour, nothing written to your Drive and not blocked by `GOG_READONLY`; it needs the blob store a hosted deployment lends this server, so a local stdio install is told to use another mode |
| `gog_gmail_url` | Print Gmail web URLs for one or more threads |
| `gog_gmail_history` | List Gmail history events since a given historyId |
| `gog_gmail_messages_search` | Search individual messages rather than threads — one result per matching message |

### Threads

| Tool | Description |
|------|-------------|
| `gog_gmail_thread_get` | Get a thread with all messages, optionally with sanitized content and attachments |
| `gog_gmail_thread_modify` | Modify labels on all messages in a thread |
| `gog_gmail_thread_attachments` | List or download all attachments in a thread |

### Labels

| Tool | Description |
|------|-------------|
| `gog_gmail_labels_list` | List all labels |
| `gog_gmail_labels_get` | Get label details and counts |
| `gog_gmail_labels_create` | Create a new label |
| `gog_gmail_labels_rename` | Rename a label |
| `g

_meta.json

{
  "ownerId": "kn700jq4sjtf2anb0rk3ft4p7n856872",
  "slug": "gogcli-mcp-gmail",
  "version": "4.7.0",
  "publishedAt": 1791380437242
}

CHANGELOG.md

# Changelog

## [2.1.0](https://github.com/chrischall/gogcli-mcp/compare/v2.0.13...v2.1.0) (2026-05-25)


### Features

* **gmail:** add gogcli-mcp-gmail sub-package ([fac0f51](https://github.com/chrischall/gogcli-mcp/commit/fac0f515fd2ea587c570d7ac70c080cb8dc486ac))


### Refactor

* aggressive cleanup pass (audit findings) ([e635b39](https://github.com/chrischall/gogcli-mcp/commit/e635b391cf611e9c102a422ffbce5ebe28687b80))
* review-pass cleanup (enums, shared schemas, test harness) ([ea851de](https://github.com/chrischall/gogcli-mcp/commit/ea851deb30b9cfef3f07ed506a011fc363b34018))


### Documentation

* update gogcli repo URLs to openclaw/gogcli (was steipete/gogcli) ([951a181](https://github.com/chrischall/gogcli-mcp/commit/951a1818ebc269f203aee723ccbea32c13817d8b))

skill-card.md

## Description:

Helps agents read, organize, draft, and send Gmail messages through tools for threads, labels, attachments, bulk actions, and account settings.

This skill is ready for commercial/non-commercial use.

## Publisher:

[chrischall](https://clawhub.ai/user/chrischall)

### License/Terms of Use:

MIT

## Use Case:

People and teams using an agent to manage Gmail can search mail, work with threads and attachments, prepare replies or forwards, organize messages, and manage mailbox settings.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Broad Gmail read/write and settings access can expose or change sensitive mail and account settings.

Mitigation: Grant access only to an appropriate account; use a dedicated account or enable GOG_READONLY when only reads are needed.

Risk: Some destructive Gmail and settings deletions can be forced without a separate user-confirmation flow.

Mitigation: Review and explicitly approve destructive actions, especially deletion of labels, filters, drafts, and send-as aliases.

Risk: Stored Gmail credentials could be exposed on an insufficiently isolated host.

Mitigation: Use a secure keyring backend and strong host isolation.

## Reference(s):

- [ClawHub skill listing](https://clawhub.ai/chrischall/skills/gogcli-mcp-gmail)
- [gogcli dependency documentation](https://github.com/openclaw/gogcli)

## Skill Output:

**Output Type(s):** [Text, JSON, Configuration guidance]

**Output Format:** [Structured Gmail data and text guidance]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [May include message contents, attachment links, and local file paths.]

## Skill Version(s):

4.7.0 (source: server release and package.json)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 3h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.