AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
MCP verified MIT Self-run

Gmail Mcp

mcp-annyzhou-gmail-mcp · by annyzhou

Gmail MCP Server

↗ Repository
— No reviews yet
0 installs
36 views
0.0% view→install

Install

$ agentstack add mcp-annyzhou-gmail-mcp

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/mcp-annyzhou-gmail-mcp)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
○ 8mo ago

Declared compatibility

Claude CodeClaude DesktopCursorWindsurf

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Gmail Mcp? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

gmail-mcp

A Gmail MCP server using OAuth2 bearer token auth via the Dedalus MCP framework.

Tools

Messages

  • gmail_list_messages - List messages with search queries
  • gmail_get_message - Get a specific message by ID
  • gmail_send_message - Send an email
  • gmail_trash_message - Move message to trash
  • gmail_untrash_message - Remove message from trash
  • gmail_modify_message - Add/remove labels on a message

Threads

  • gmail_list_threads - List email threads (conversations)
  • gmail_get_thread - Get a thread with all messages
  • gmail_trash_thread - Move thread to trash

Labels

  • gmail_list_labels - List all labels
  • gmail_get_label - Get label details
  • gmail_create_label - Create a new label
  • gmail_delete_label - Delete a user label

Drafts

  • gmail_list_drafts - List draft emails
  • gmail_get_draft - Get a draft by ID
  • gmail_create_draft - Create a draft
  • gmail_send_draft - Send a draft
  • gmail_delete_draft - Delete a draft

Profile

  • gmail_get_profile - Get user's Gmail profile

Authentication

Gmail API requires OAuth2. The access token is provided at runtime via Dedalus credential exchange.

Required OAuth scopes (depending on operations):

  • https://www.googleapis.com/auth/gmail.readonly - Read-only access
  • https://www.googleapis.com/auth/gmail.send - Send emails
  • https://www.googleapis.com/auth/gmail.modify - Modify messages/labels
  • https://www.googleapis.com/auth/gmail.compose - Create drafts

Usage

Prerequisites

  1. A Dedalus API key (dsk-live-* or dsk-test-*)
  2. The dedalus-labs Python SDK installed

Environment Variables

DEDALUS_API_KEY=dsk-live-your-key-here
DEDALUS_API_URL=https://api.dedaluslabs.ai
DEDALUS_AS_URL=https://as.dedaluslabs.ai

Example Client

See [src/_client.py](src/_client.py) for a complete example client that handles the OAuth browser flow.

The first time you use the MCP server, you'll be prompted to authorize Gmail access via OAuth.

OAuth Flow

  1. On first request, you'll receive an AuthenticationError with a connect_url
  2. Open the URL in a browser to authorize Gmail access
  3. After authorization, retry the request - credentials are now stored
  4. Subsequent requests will work without re-authorization

Local Development

cd gmail-mcp
uv sync
uv run python src/main.py

API Reference

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Communication