Gmail FAQs

Question 1

What is the Gmail Reader MCP Server?

Accepted Answer

It's a Model Context Protocol (MCP) server that grants read-only access to your Gmail account. It exposes email subjects, senders, labels, categories, and full content to LLM-powered tools like VS Code Copilot and Claude Desktop for enhanced AI workflows.

Question 2

Is this tool safe and what level of access does it have?

Accepted Answer

Yes, it's designed for security with a strictly read-only scope. It only uses the `https://www.googleapis.com/auth/gmail.readonly` OAuth scope, ensuring it can read email content and metadata but cannot send, delete, or modify any part of your Gmail account.

Question 3

What specific Gmail information can I retrieve using this tool?

Accepted Answer

You can retrieve your Gmail profile (email, total messages), list all labels with counts, search/list emails by query or label (metadata and full content), get the complete text/HTML body of any specific email, and filter newsletters.

Question 4

What are the prerequisites to set up and use this tool?

Accepted Answer

You need Node.js 18+, a Google Cloud project with the Gmail API enabled, and OAuth 2.0 Desktop credentials (`credentials.json`) configured via the Google Cloud Console. Comprehensive setup instructions are provided.

Question 5

How do I connect this Gmail MCP server to my LLM client?

Accepted Answer

After initial setup and OAuth authorization, you configure your LLM client (e.g., VS Code Copilot, Claude Desktop) by adding a server entry to its configuration file. This entry specifies the command to run the `gmail-mcp` server and the absolute path to your `credentials.json` file.

Gmail

Gmail

Key Features

Use Cases

Key Features

Use Cases