Gmail MCP 서버

무엇을 하나요

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

Gmail MCP 서버 설치 방법

Smithery CLI 한 줄로 설치하고, 설치 중에 아래 설정값을 넣습니다.

Claude Desktop

npx -y @smithery/cli install gmail --client claude

Cursor

npx -y @smithery/cli install gmail --client cursor

원격 서버 주소 (Streamable HTTP)

https://gmail.run.tools

키와 비밀번호는 원 제공처와 내 컴퓨터에만 넣습니다. ListeningMind는 받지 않습니다.

제공 도구 31개

• Arcade_ListApps 현재 호출자가 조작할 수 있는 앱과 연결 여부를 확인합니다. 각 앱의 id, name, 연결 상태, (연결된 경우) 연결된 계정을 반환합니다.
• Gmail_ArchiveEmail 정확히 하나의 이메일을 보관 처리합니다. 받은편지함에서 제거되지만 검색은 가능한 상태로 유지됩니다.
• Gmail_ChangeEmailLabels 호출당 최대 50개의 메시지에 사용자가 생성한 라벨 1개를 추가하거나 제거합니다. 이미 요청된 상태인 메시지는 noop 처리되지만, 쿼리 모드에서는 멱등성이 보장되지 않아 반복 호출 시…
• Gmail_ChangeThreadLabels Gmail API를 사용하여 스레드의 모든 메시지에서 라벨을 추가 및 제거합니다. 전체 대화를 한 번에 변경할 때(예: "UNREAD"를 제거하여 스레드를 읽음 상태로 표시) 사용…
• Gmail_CreateLabel 사용자의 편지함에 새 라벨을 생성합니다. Gmail은 라벨 이름을 대소문자 구분 없이 고유하게 취급하므로, 이미 존재하는 이름을 생성하면 중복이 아닌 충돌이 보고됩니다.
• Gmail_DeleteDraftEmail Gmail API를 사용하여 이메일 임시보관본을 삭제합니다.
• Gmail_DeleteLabel 사용자가 지정한 이름으로 확인하여 사용자가 생성한 라벨을 삭제합니다. 오타가 있는 이름은 유사한 제안을 받고, 시스템 라벨은 거부됩니다.
• Gmail_ForwardEmail 메시지 사본을 새 대화로서 새 수신자에게 전송합니다. 전달 시 원본 본문이 인용되고 제목 앞에 Fwd:가 붙으며, 파일명이 있는 첨부 파일이 포함되고…
• Gmail_GetEmail 스레드의 나머지 부분을 로드하지 않고 ID로 단일 메시지를 읽습니다. 파싱된 발신자 및 수신자 헤더, 제목, 텍스트 및 HTML 본문, 라벨, 날짜, 첨부 파일 메타데이터…를 반환합니다.
• Gmail_GetThread ID로 지정된 스레드를 가져옵니다.
• Gmail_ListDraftEmails Gmail API를 사용하여 사용자의 임시보관함에 있는 임시보관 이메일 목록을 조회합니다.
• Gmail_ListEmailAttachmentMetadata 내용을 로드하지 않고 메시지의 실제 첨부 파일에 대한 메타데이터를 나열합니다.
• Gmail_ListEmails Gmail 계정에서 이메일을 읽습니다. 대용량 분류 작업이 컨텍스트 예산 내에서 유지되도록 기본적으로 메타데이터 전용 행(body/htmlbody 없음)을 반환합니다.
• Gmail_ListEmailsByHeader Gmail API를 사용하여 헤더로 이메일을 검색합니다. 기본적으로 메타데이터 전용 행(body/htmlbody 없음)을 반환합니다. 전체 메시지 본문이 필요한 경우 includebody=True를 전달하세요.
• Gmail_ListLabels 사용자의 편지함에 있는 모든 라벨 목록을 조회합니다.
• Gmail_ListThreads 사용자의 편지함에 있는 스레드 목록을 조회합니다. 기본적으로 no-reply 발신자 패턴 및 Gmail의 기본(Primary) 외 카테고리 필터(프로모션 등)를 사용하여 명백한 자동화 스레드는 결과에서 제외됩니다…
• Gmail_ReplyToEmail 이메일 메시지에 답장을 전송하며, 선택적으로 하나 이상의 파일을 첨부할 수 있습니다.
• Gmail_ReportSpam 정확히 하나의 이메일을 스팸으로 신고합니다. 스팸함으로 이동하고 받은편지함에서 제거합니다.
• Gmail_SearchEmailsByQuery raw 쿼리로 Gmail을 검색하고 요청된 상세 모드의 한 페이지를 반환합니다. 결과는 Gmail의 기본값인 최신순 정렬을 따릅니다.
• Gmail_SearchThreads 사용자의 편지함에서 스레드를 검색합니다.
• Gmail_SendDraftEmail Gmail API를 사용하여 임시보관 이메일을 전송합니다.
• Gmail_SendEmail Gmail API를 사용하여 이메일을 전송하며, 선택적으로 하나 이상의 파일을 첨부할 수 있습니다.
• Gmail_SetThreadTrashStatus 전체 대화의 Trash 포함 여부를 설정하며 모든 메시지에 한 번에 적용됩니다. 현재 상태와 동일하게 재설정해도 대화를 변경하지 않고 성공 처리됩니다.
• Gmail_TrashEmail 정확히 하나의 이메일을 Trash로 이동합니다(복구 가능, 나중에 자동 영구 삭제될 수 있음).
• Gmail_TriageEmails 호출당 최대 50개의 선택된 메시지에 하나의 분류 전환을 적용합니다. 메시지별 전환은 수렴되어 이미 요청된 상태인 메시지는 noop 처리되지만, 도구 자체는 멱등성을…
• Gmail_UnsubscribeFromEmail 인증된 마케팅 메일에서 수신 거부를 요청하고 선택적으로 휴지통으로 보냅니다.
• Gmail_UpdateDraftEmail Gmail API를 사용하여 기존 이메일 임시보관본을 업데이트합니다. 단일 파트 text/plain 및 단일 파트 text/html 임시보관본 모두 전체 본문 대체를 지원하며, 재작성은 기존 임시보관본…
• Gmail_UpdateLabel 사용자가 지정한 이름으로 확인하여 사용자가 생성한 라벨의 이름을 변경합니다. 라벨의 색상 및 가시성 설정은 유지됩니다.
• Gmail_WhoAmI 종합적인 사용자 프로필 및 Gmail 계정 정보를 가져옵니다. 이 도구는 이름, 이메일, 프로필 사진, Gmail… 등 인증된 사용자에 대한 세부 정보를 제공합니다.
• Gmail_WriteDraftEmail Gmail API를 사용하여 새 이메일 임시보관본을 작성하며, 선택적으로 파일을 첨부할 수 있습니다.
• Gmail_WriteDraftReplyEmail 이메일 메시지에 대한 임시보관 답장을 작성하며, 선택적으로 하나 이상의 파일을 첨부할 수 있습니다.

왜 골랐나 · #7 · 점수 77

• 인기 (41%)84
• 신뢰 (29%)80
• 회원 평가이번 주 미반영
• 검색 수요 (18%)84
• 검색·AI 개요 평판 (12%)30

출처: Smithery · 57,738 uses · 월 검색량 1,400 · 처음 선정 2026-10-20

신뢰 점검

• ✓ 원 카탈로그 인증
• ✓ 공식 MCP 레지스트리 등록
• – 자체 홈페이지
• ✓ 바로 연결되는 서버
• ✓ 충분한 설명

선정 기준 전체 보기 →

만든 분이라면: README에 배지 달기

[![ListeningMind pick](https://daas.listeningmind.ai/badge/mcps/x-mcp-gmail.svg)](https://daas.listeningmind.ai/en/catalog/mcps/x-mcp-gmail)

사는 방법

평가 ·

아직 평가가 없습니다.

자주 묻는 질문