Pod

Yes, this is on purpose. Pod is built for agents, so the default page is plain HTML.
Human? View the normal website.
Agent? You probably prefer /mcp/io-github-artymclabin-gmail-mcp-server/issues.md or /mcp/io-github-artymclabin-gmail-mcp-server/issues.json, or Pod over MCP.

Reported issues for io.github.ArtyMcLabin/Gmail-MCP-Server

Pod holds 13 of 13 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to io.github.ArtyMcLabin/Gmail-MCP-Server.

Most discussed

README.md out of date — source changed without docs update (3e14d51)

README gap detected by CI

A push to experimental changed source code without updating README.md.

src/index.ts
src/tool-prefix.test.ts
src/tool-prefix.ts

Read the thread · 2026-05-22 · closed · external user · 1 comment

Publish maintained fork as an npm package

Context

The README now points users at the maintained GitHub package spec:

npx -y ArtyMcLabin/Gmail-MCP-Server@latest

That works, but it is less familiar than a normal npm package name and can be confused with scoped package syntax.

Why publish to npm

Read the thread · 2026-05-04 · closed · external user · 2 comments

list_filters always returns empty despite filters existing

Bug: list_filters returns no results when filters exist

Description

The list_filters tool always returns "No filters found" regardless of how many filters are actually configured in the Gmail account. The Gmail Settings UI and the exported XML both confirm filters exist — the tool is simply not returning them.

Steps to reproduce

  1. Have one or more filters configured in your Gmail account
  2. Call list_filters via the MCP server
  3. Observe: returns "No filters found"

Read the thread · 2026-04-25 · closed · external user · 5 comments

Error : Failed to list filters: invalid grant

It worked well on claude as a connector the first time, but afterwards it kept giving this error.

Unable to disconnect and reconnect it. Trying to disconnect or remove the connector gives 2 error prompts

Invalid server ID format. Expected UUID or mcpsrv_* tagged ID Failed to disconnect from the server

When i change the scope of auth to basic to get all tools

You can't sign in to this app because it doesn't comply with Google's OAuth 2.0 policy for keeping apps secure.

You can let 

[Read the thread](https://github.com/ArtyMcLabin/Gmail-MCP-Server/issues/25) · 2026-04-21 · closed · external user · 2 comments

### feat: add report phishing action for Gmail messages

## Summary
Gmail users often need a way to explicitly report messages as phishing, not just move them to Spam. The current MCP surface appears to support search, read, labels, move/delete, and filters, but it does not expose a dedicated phishing-report action.

## Problem
When a client asks to "report phishing", the server can only confirm that a message is already in Spam or offer adjacent actions such as delete, archive, or labeling. That falls short of the Gmail product behavior users expect 

[Read the thread](https://github.com/ArtyMcLabin/Gmail-MCP-Server/issues/23) · 2026-04-15 · closed · external user · 2 comments

### README contains commands referencing unmaintained fork, not this repo

The README commands say to do `npx @gongrzhe/server-gmail-autoauth-mcp auth`, but this fails because that's the old repo.

[Read the thread](https://github.com/ArtyMcLabin/Gmail-MCP-Server/issues/22) · 2026-04-11 · closed · external user · 2 comments

### Unable to start session

I just attempted to set this up under Claude Desktop on Mac OS. A couple things:

1. I was unable to specify a scope, just got a Google error "bad request"
2. Claude spits back an error when I try to get it use the MCP: `Unable to start session. The authentication server returned an error (500). You can try again.`

I don't know where to star to troubleshoot this.

[Read the thread](https://github.com/ArtyMcLabin/Gmail-MCP-Server/issues/20) · 2026-04-07 · closed · external user · 1 comment

### Google Chat features

It'd be great to also support Google Chat :-)

[Read the thread](https://github.com/ArtyMcLabin/Gmail-MCP-Server/issues/16) · 2026-03-26 · closed · external user · 1 comment

## Most recent

### [FEATURE] Gmail MCP Connector: expose GetMessageAttachment so inbound attachments can be read

The Gmail connector returns attachment metadata (id, filename, mimeType) but provides no tool to fetch attachment content. Attachments are visible and unreadable.
This is a narrower ask than #28575, which covers outbound attachments on gmail_create_draft (now shipped) and a send tool. This issue is about the inbound direction only, and it does not require any new capability — just surfacing something the connector’s own schema already references.
Evidence the API already supports it
The Attachme

[Read the thread](https://github.com/ArtyMcLabin/Gmail-MCP-Server/issues/48) · 2026-08-10 · open · external user · 0 comments

### README.md out of date — source changed without docs update (29474ba)

## README gap detected by CI

A push to `experimental` changed source code without updating README.md.

- **Commit:** [`29474ba`](https://github.com/ArtyMcLabin/Gmail-MCP-Server/commit/29474bad73e2e7f64187cef2a753c0a5a5774623) — Merge pull request #35 from BrentBaccala/fix-oauth-refresh-token-persistence
- **Branch:** `experimental`
- **CI run:** https://github.com/ArtyMcLabin/Gmail-MCP-Server/actions/runs/29101363000
- **Source files changed:**

src/index.ts


### What to do
1. Review the

[Read the thread](https://github.com/ArtyMcLabin/Gmail-MCP-Server/issues/42) · 2026-07-10 · closed · external user · 1 comment

### Allow other ports beside 3000 for the OAuth flow

# Summary

The auth command accepts a custom OAuth callback URL as a positional argument, but the local HTTP server that catches the redirect always binds to port 3000 and only matches the `/oauth2callback` path. As a result, passing any callback URL with a different port or path is accepted without error but the flow hangs — Google redirects to a port/path where nothing is listening.

# Steps to reproduce

1. Register a redirect URI with a non-3000 port in Google Cloud Console, e.g. `http://loc

[Read the thread](https://github.com/ArtyMcLabin/Gmail-MCP-Server/issues/40) · 2026-07-08 · closed · external user · 1 comment

### delete_email fails with Insufficient Permission — requires https://mail.google.com/ scope, not gmail.modify

## Bug

`delete_email` and `batch_delete_emails` return `Insufficient Permission` even when authenticated with `gmail.modify` scope.

## Root Cause

The Gmail API `messages.delete` endpoint requires the `https://mail.google.com/` scope. `gmail.modify` is not sufficient for permanent deletion. This is documented in the [Gmail API reference](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/delete).

## Current Behavior

- Authenticate with `gmail.modify,gmail.settings.basic

[Read the thread](https://github.com/ArtyMcLabin/Gmail-MCP-Server/issues/38) · 2026-06-23 · closed · external user · 1 comment

### feat: schedule send emails

functionality so emails can be send be scheduled

[Read the thread](https://github.com/ArtyMcLabin/Gmail-MCP-Server/issues/36) · 2026-06-09 · closed · external user · 1 comment

The remaining reports are on [the project's issue tracker](https://github.com/ArtyMcLabin/Gmail-MCP-Server/issues).