# Headless Gmail

> Use this tool when you need to access Gmail functionality in headless or remote applications without requiring local credential setup or browser access. It solves problems of credential storage and implementation separation, enabling clients to complete OAuth flows independently and access emails, send messages, and handle token refreshes through a clean API. Ideal for containerized environments, it provides a secure and efficient way to integrate Gmail functionality into automated workflows.

Canonical page: https://skillsregistry.net/skills/baryhuang-headless-gmail  
JSON: https://api.skillsregistry.net/v1/skills/baryhuang-headless-gmail

## Description

MCP Headless Gmail Server provides a way to access Gmail functionality without requiring local credential setup or browser access. Built by baryhuang, it enables any client to complete the OAuth flow independently and then pass credentials as context to the server, creating a complete separation between credential storage and implementation. The server supports getting recent emails, sending messages, and handling token refresh operations through a clean API that works in containerized environments. This implementation is particularly valuable for headless or remote applications where traditional Gmail access methods requiring local file access or browser interaction are not feasible.

## Trust

- **Trust score (0–1):** 0.76
- **Verification tier:** scanned
- **Last scanned:** 2026-09-28

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** browser-automation
- **Updated:** 2026-09-28

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/baryhuang-headless-gmail)
- **Repository:** <https://github.com/baryhuang/mcp-headless-gmail>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "baryhuang-headless-gmail"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/baryhuang-headless-gmail` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/baryhuang-headless-gmail/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt