Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [Bug] Gmail MCP connector missing `gmail.modify` scope — four documented tools don't register [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#53738•Fetched 2026-04-28 06:48:20
View on GitHub
Comments
1
Participants
2
Timeline
5
Reactions
0
Author
aRobGibsonaRobGibson
Participants
aRobGibsonaRobGibsongithub-actions[bot]github-actions[bot]
Timeline (top)
labeled ×4commented ×1

Code Example

[]
RAW_BUFFERClick to expand / collapse

Bug Description Reply landed in team/inbox/saskia/2026-04-27-gmail-mcp-modify-scope-filing.md, CC in your inbox. Both my open items archived.

The "loaded the schemas" claim was overreach on my part — docstring inference + a namespace pattern guess, not actual loads. Saskia caught it. Owned it in writing in the reply file.

Bug content for /feedback — paste this when you fire it:

Title: Gmail connector missing gmail.modify scope — four already-documented verbs don't register

Body:

Per-install Gmail MCP connector (UUID namespace mcp__ca6440c6-e83e-454e-9e19-0e92e0284af8__*) registers six tools in-session: create_draft, create_label, get_thread, list_drafts, list_labels, search_threads.

The list_labels tool docstring explicitly references four sibling verbs as if they're available: label_thread, unlabel_thread, label_message, unlabel_message. None of them register. ToolSearch in-session returns nothing under the UUID namespace, the mcp__claude_ai_Gmail__* pattern, or any capability-based query.

Disconnect+reconnect via /mcp (ran four times, watched consent screen) shows Google's "Claude has this access" panel granting:

  • View your email messages and settings
  • Manage drafts and send emails
  • See your primary Google Account email address
  • Associate you with your personal info on Google

No "Manage your mail" / "Modify your mail" line. The connector isn't requesting gmail.modify at consent-generation time, so the modify-scope-gated tools can't register.

Ask: declare gmail.modify in the connector manifest so the four documented verbs surface. The docstring already references them — the gap is purely in the OAuth scope declaration, not the tool definitions.

Impact: without modify, no archive (= remove INBOX label), no apply user-defined labels, no thread-level mail organization. Read + drafts work fine.

Environment Info

  • Platform: darwin
  • Terminal: Apple_Terminal
  • Version: 2.1.119
  • Feedback ID: ee02e402-fbac-400a-9198-65c87e181522

Errors

[]

extent analysis

TL;DR

Declare gmail.modify in the connector manifest to enable the registration of four documented verbs.

Guidance

  • The issue is caused by the Gmail connector not requesting the gmail.modify scope during consent generation, resulting in the inability to register certain tools.
  • To verify the fix, check the Google consent screen for the "Manage your mail" or "Modify your mail" line after declaring gmail.modify in the connector manifest.
  • The four documented verbs (label_thread, unlabel_thread, label_message, unlabel_message) should be registered and functional after the fix.
  • Review the connector manifest documentation to ensure correct declaration of the gmail.modify scope.

Example

No code snippet is provided as the issue is related to configuration and manifest declaration.

Notes

The fix assumes that declaring gmail.modify in the connector manifest is sufficient to enable the registration of the four documented verbs. Additional configuration or code changes may be required if the issue persists.

Recommendation

Apply workaround: Declare gmail.modify in the connector manifest, as this is the most direct solution to enable the registration of the four documented verbs.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#container setup#orchestration issue#cache issue#memory leak#API versioning

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [Bug] Gmail MCP connector missing `gmail.modify` scope — four documented tools don't register [1 comments, 2 participants]