io.github.markswendsen-code/gmail
Gmail MCP server — send, read, and search email. By Strider Labs.
Open source Open in the app JSON README (API)
About
Gmail MCP server — send, read, and search email. By Strider Labs.
Details
- Kind
- MCP servers
- Topic
- Communication
- Publisher
- markswendsen-code
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.0
- Last push
- 2026-06-18T01:07:10Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 04:00:29
- Updated
- 2026-08-29 04:00:29
- Origin id
io.github.markswendsen-code/gmail
README
# @striderlabs/mcp-gmail
MCP server that gives AI agents the ability to send, read, and search email via Gmail.
## For Agents
Agents use this connector to handle email autonomously on behalf of their human — reading important messages, searching for information, composing thoughtful replies, and sending communications.
**Example agent workflows:**
1. **Triage emails:** Agent reads new messages, summarizes important ones, and flags urgent items for user attention
2. **Answer routine questions:** Agent searches email history to find information, composes replies with context from past conversations
3. **Send on behalf:** Agent drafts and sends professional emails based on user intent ("Let the team know I'll be late"), then logs a copy to the conversation
**Usage example:**
> User: "Has anyone replied to my email about the Q2 budget proposal?"
Agent:
1. `gmail_search` → `"to:me subject:budget"`
2. `gmail_read` → Read each message
3. Return summary: "Sarah replied yes on Monday. Mark asked for revisions. No word from Finance yet."
Then agent might automatically draft a follow-up to Finance and ask for approval before sending.
## Installation
```bash
npx @striderlabs/mcp-gmail
```
## Configuration
Add to your MCP client configuration (e.g., Claude Desktop):
```json
{
"mcpServers": {
"strider-gmail": {
"command": "npx",
"args": ["-y", "@striderlabs/mcp-gmail"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id",
"GOOGLE_CLIENT_SECRET": "your-client-secret",
"GOOGLE_REFRESH_TOKEN": "your-refresh-token"
}
}
}
}
```
## Available Tools
### gmail_send
Send an email from the user's Gmail account.
**Parameters:**
- `to` (required): Recipient email address
- `subject` (required): Email subject line
- `body` (required): Email body content
- `cc` (optional): CC recipients
- `bcc` (optional): BCC recipients
### gmail_search
Search emails using Gmail search syntax.
**Parameters:**
- `query` (required): Gmail search query (e.g., "from:example@gmail.com")
- `maxResults` (optional): Maximum results (default: 10)
### gmail_read
Read the full content of a specific email.
**Parameters:**
- `messageId` (required): The Gmail message ID
### gmail_list
List recent emails from the inbox.
**Parameters:**
- `maxResults` (optional): Maximum emails to list (default: 10)
- `label` (optional): Filter by label (e.g., "INBOX", "UNREAD")
## Getting Google OAuth Credentials
1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Create a new project or select existing
3. Enable the Gmail API
4. Create OAuth 2.0 credentials
5. Use the OAuth playground or your app to get a refresh token
## Response Format
All tools return structured JSON:
```json
{
"success": true,
"messageId": "...",
"message": "Email sent successfully"
}
```
## Part of Strider Labs
Strider Labs builds action execution infrastructure for AI agents.
- Website: https://striderlabs.ai
- GitHub: https://github.com/striderlabs
## License
MIT