# Gmail MCP 서버

> Gmail 메시지를 검색·전송하고 임시 보관함, 라벨, 메일함을 관리합니다.

- 가격: 무료로 연결 · 원 제공처 요금 별도
- URL: https://daas.listeningmind.ai/ko/catalog/mcps/x-mcp-gmail
- 출처: Smithery https://smithery.ai/server/gmail
- 이번 주 순위: #7 (score 77)

## 설치

```
npx -y @smithery/cli install gmail --client claude
```
- Remote: https://gmail.run.tools

## 도구 (31)

- `Arcade_ListApps`: See the apps the current caller can act on and whether they are connected. Returns each app's id, name, connected state, and (when connected) the account it is connected as.
- `Gmail_ArchiveEmail`: Archive exactly one email: remove inbox membership; email stays searchable.
- `Gmail_ChangeEmailLabels`: Add or remove one user-created label on at most 50 messages per call. A message already in the requested state is a noop, but the tool is not idempotent in query mode: repeated cal…
- `Gmail_ChangeThreadLabels`: Add and remove labels on every message in a thread using the Gmail API. Use this to change a whole conversation at once (for example, marking a thread read by removing "UNREAD") in…
- `Gmail_CreateLabel`: Create a new label in the user's mailbox. Gmail treats label names as case-insensitive-unique; creating a name that already exists reports a conflict rather than a duplicate.
- `Gmail_DeleteDraftEmail`: Delete a draft email using the Gmail API.
- `Gmail_DeleteLabel`: Delete a user-created label, resolving it by the name the user says. A misspelled name gets a close-match suggestion; a system label is rejected.
- `Gmail_ForwardEmail`: Send a copy of one message to new recipients as a new conversation. The forward quotes the original body, prefixes the subject with Fwd:, carries filename-bearing attachments, and…
- `Gmail_GetEmail`: Read one message by ID without loading the rest of its thread. Returns parsed sender and recipient headers, the subject, text and HTML bodies, labels, dates, and attachment metadat…
- `Gmail_GetThread`: Get the specified thread by ID.
- `Gmail_ListDraftEmails`: Lists draft emails in the user's draft mailbox using the Gmail API.
- `Gmail_ListEmailAttachmentMetadata`: List metadata for a message's real attachments without loading their contents.
- `Gmail_ListEmails`: Read emails from a Gmail account. By default returns metadata-only rows (no body/htmlbody) so high-volume triage stays within the context budget.
- `Gmail_ListEmailsByHeader`: Search for emails by header using the Gmail API. By default returns metadata-only rows (no body/htmlbody). Pass includebody=True when full message text is needed.
- `Gmail_ListLabels`: List all the labels in the user's mailbox.
- `Gmail_ListThreads`: List threads in the user's mailbox. By default, obvious automated threads are excluded from results using no-reply sender patterns and Gmail's non-primary category filters (promoti…
- `Gmail_ReplyToEmail`: Send a reply to an email message, optionally with one or more file attachments.
- `Gmail_ReportSpam`: Report exactly one email as spam: move to Spam and remove from the inbox.
- `Gmail_SearchEmailsByQuery`: Search Gmail with a raw query and return one page in the requested detail mode. Results follow Gmail's default newest-first order.
- `Gmail_SearchThreads`: Search for threads in the user's mailbox.
- `Gmail_SendDraftEmail`: Send a draft email using the Gmail API.
- `Gmail_SendEmail`: Send an email using the Gmail API, optionally with one or more file attachments.
- `Gmail_SetThreadTrashStatus`: Set whether an entire conversation is in Trash, affecting every message at once. Setting the current status again succeeds without changing the conversation.
- `Gmail_TrashEmail`: Move exactly one email to Trash (recoverable; may be auto-purged later).
- `Gmail_TriageEmails`: Apply one triage transition to at most 50 selected messages per call. Per-message transitions converge — a message already in the requested state is a noop — but the tool is not id…
- `Gmail_UnsubscribeFromEmail`: Request removal from authenticated marketing mail and optionally trash it.
- `Gmail_UpdateDraftEmail`: Update an existing email draft using the Gmail API. Single-part text/plain and single-part text/html drafts both support full body replacement; the rebuild follows the existing dra…
- `Gmail_UpdateLabel`: Rename a user-created label, resolving it by the name the user says. The label's color and visibility settings are preserved.
- `Gmail_WhoAmI`: Get comprehensive user profile and Gmail account information. This tool provides detailed information about the authenticated user including their name, email, profile picture, Gma…
- `Gmail_WriteDraftEmail`: Compose a new email draft using the Gmail API, optionally with file attachments.
- `Gmail_WriteDraftReplyEmail`: Compose a draft reply to an email message, optionally with one or more file attachments.

## FAQ

### Gmail MCP 서버는 무엇인가요?

Gmail 메시지를 검색·전송하고 임시 보관함, 라벨, 메일함을 관리합니다. Smithery에 등록된 항목으로, ListeningMind.AI가 매주 고르는 엄선 목록에서 7위(점수 77)입니다.

### Gmail MCP 서버는 어떻게 설치하나요?

터미널에서 npx -y @smithery/cli install gmail --client claude 를 실행하면 Claude Desktop에 연결됩니다. Cursor는 --client cursor 로 바꿉니다.

### API 키가 필요한가요?

원 제공처 등록 정보에 필수 설정값이 없습니다.

### 어떤 도구를 제공하나요?

31개입니다: Arcade_ListApps, Gmail_ArchiveEmail, Gmail_ChangeEmailLabels, Gmail_ChangeThreadLabels, Gmail_CreateLabel, Gmail_DeleteDraftEmail, Gmail_DeleteLabel, Gmail_ForwardEmail, Gmail_GetEmail, Gmail_GetThread, Gmail_ListDraftEmails, Gmail_ListEmailAttachmentMetadata.

### 요금은 얼마인가요?

무료로 연결 · 원 제공처 요금 별도. 사용료는 원 제공처 기준으로 따로 붙을 수 있습니다.

### 믿고 써도 되나요?

통과한 점검: 원 카탈로그 인증, 공식 MCP 레지스트리 등록, 바로 연결되는 서버, 충분한 설명. 처음 쓰는 서버·저장소는 내용을 한번 확인한 뒤 연결하세요.