Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [BUG] Claude for Gmail connector lacks gmail.modify scope — label_thread returns permission error [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#46206•Fetched 2026-04-11 06:26:21
View on GitHub
Comments
1
Participants
2
Timeline
7
Reactions
0
Author
techa501p-hubtecha501p-hub
Participants
github-actions[bot]github-actions[bot]techa501p-hubtecha501p-hub
Timeline (top)
labeled ×4closed ×1commented ×1unlabeled ×1

Error Message

The label_thread tool returns a permission error when called via the Gmail connector in Claude Code.

Error Messages/Logs

  1. Error occurs: "This connector requires additional permissions"

Root Cause

Checking Google Account permissions at myaccount.google.com/permissions shows that "Claude for Gmail" only has:

  • View profile info
  • Manage drafts and send emails
  • View email messages and settings

The gmail.modify scope (required for labeling) is NOT included.

Code Example

This connector requires additional permissions. The user needs to reconnect it with the appropriate access.
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

Problem

The label_thread tool returns a permission error when called via the Gmail connector in Claude Code.

Root Cause

Checking Google Account permissions at myaccount.google.com/permissions shows that "Claude for Gmail" only has:

  • View profile info
  • Manage drafts and send emails
  • View email messages and settings

The gmail.modify scope (required for labeling) is NOT included.

Reconnection Blocked

Attempting to reconnect the Gmail connector shows a hard "This app is blocked" screen from Google with no way to bypass it. There is no "Advanced" / "Proceed anyway" option.

Expected Behavior

The Gmail connector should request the gmail.modify scope so that label_thread and similar write operations work.

Environment

  • Claude Code on macOS
  • Gmail connector (Claude for Gmail)

What Should Happen?

The Gmail connector should request the gmail.modify scope during OAuth authorization, so that label_thread and other write operations work correctly.

Error Messages/Logs

This connector requires additional permissions. The user needs to reconnect it with the appropriate access.

Steps to Reproduce

  1. Set up a scheduled task that calls label_thread via the Gmail connector
  2. Run the task
  3. Error occurs: "This connector requires additional permissions"
  4. Attempt to reconnect the Gmail connector in Claude Code settings
  5. Google shows a hard "このアプリはブロックされます" (This app is blocked) screen with no way to proceed

Claude Model

Sonnet (default)

Is this a regression?

I don't know

Last Working Version

No response

Claude Code Version

1.569.0(49894a)

Platform

Other

Operating System

macOS

Terminal/Shell

Other

Additional Information

Platform: Claude Code (desktop app, macOS)

extent analysis

TL;DR

The most likely fix is to update the Gmail connector's OAuth authorization to request the gmail.modify scope, allowing write operations like label_thread to work correctly.

Guidance

  • Verify that the gmail.modify scope is not included in the current permissions by checking the Google Account permissions page at myaccount.google.com/permissions.
  • Attempt to modify the Gmail connector's settings to request the gmail.modify scope during OAuth authorization.
  • If the "This app is blocked" screen persists, consider reaching out to Google support to resolve the issue or explore alternative authentication methods.
  • Review the Claude Code documentation to see if there are any specific instructions for configuring the Gmail connector with the required permissions.

Example

No code snippet is provided as the issue is related to configuration and authentication rather than code.

Notes

The issue may be related to Google's security policies or the specific configuration of the Gmail connector in Claude Code. Further investigation or support from Google or the Claude Code team may be necessary to resolve the issue.

Recommendation

Apply workaround: Modify the Gmail connector's OAuth authorization to request the gmail.modify scope, as this is the most direct way to address the permission error and enable write operations like label_thread.

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…
#permission error#API middleware#SSR setup#ISR setup#authentication setup

Still need to ship something?

×6

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

Back to top recommendations

TRENDING