Gmail MCP 서버 통합

“Gmail” MCP 서버는 무엇을 하나요?

Gmail MCP 서버는 Claude Desktop과 같은 AI 플랫폼에 Gmail 기능을 통합하도록 설계된 Model Context Protocol(MCP) 서버입니다. 이 서버의 주요 역할은 AI 어시스턴트와 Gmail 사이의 다리 역할을 하여, 자연어로 이메일을 관리할 수 있도록 하는 것입니다. 여기에는 이메일 전송 및 읽기, 라벨 관리, 첨부파일 처리, 특정 메시지 검색, 일괄 작업 수행 등이 포함됩니다. 이러한 기능을 MCP 도구와 리소스로 제공함으로써, Gmail MCP 서버는 개발자가 AI 에이전트로 하여금 이메일 관리 자동화, 받은편지함에서의 문맥 데이터 추출, Gmail 콘텐츠의 프로그래밍적 제어를 구현할 수 있게 하며, 모든 과정은 안전한 OAuth2 기반 인증을 활용합니다.

프롬프트 목록

저장소나 문서에 명시적인 프롬프트 템플릿은 없습니다.

리소스 목록

• 이메일 메시지
  이메일 메시지를 리소스로 노출하여 LLM 상호작용의 컨텍스트로 읽고 활용할 수 있습니다.

• Gmail 라벨
  시스템 및 사용자 정의 Gmail 라벨에 접근할 수 있어 이메일을 체계적으로 정리하거나 검색할 수 있습니다.

• 첨부파일 메타데이터
  이메일 첨부파일의 파일명, 유형, 크기 등 정보를 조회할 수 있습니다.

• 검색 결과
  제목, 발신자, 날짜 범위 등 고급 검색으로 이메일 검색 결과를 조회할 수 있습니다.

도구 목록

문서에 기재된 주요 기능을 기반으로 Gmail MCP 서버가 제공하는 도구는 다음과 같습니다:

• send_email
  제목, 본문, 첨부파일, 수신자 지정이 가능한 이메일 전송(HTML 및 다국어 지원 포함)

• read_email
  ID로 이메일 메시지 조회(복잡한 MIME 구조 지원)

• list_labels
  사용 가능한 모든 Gmail 라벨(시스템/사용자 정의) 목록 조회

• manage_labels
  라벨 생성, 수정, 삭제, 목록 조회 등 라벨 관리

• search_emails
  제목, 보낸 사람, 날짜 등 다양한 조건으로 이메일 검색

• list_emails_by_label
  받은편지함, 보낸편지함, 사용자 정의 라벨별 이메일 목록 조회

• mark_read_unread
  이메일 읽음/안읽음 표시

• move_email
  이메일을 다른 라벨/폴더로 이동

• delete_email
  이메일 삭제

• batch_operations
  여러 이메일을 일괄 처리하는 효율적인 작업 지원

활용 사례

• 자동 이메일 전송
  AI 에이전트가 자동으로 이메일을 작성 및 전송하도록 워크플로우를 구성해 반복적인 업무를 줄일 수 있습니다.

• 받은편지함 분류 및 관리
  AI 어시스턴트가 이메일을 분류, 라벨링, 폴더 이동 등으로 정리하여 중요한 메시지에 우선 순위를 둘 수 있습니다.

• 이메일 검색 및 조회
  고급 검색 조건으로 특정 메시지나 첨부파일을 신속하게 찾아 정보 검색 시간을 단축할 수 있습니다.

• 일괄 처리
  대량 이메일 삭제, 읽음/안읽음 표시, 이동 등 반복 작업을 자동화하여 많은 이메일을 효율적으로 관리합니다.

• 라벨 관리 자동화
  AI가 Gmail 라벨을 동적으로 생성, 수정, 삭제하여 프로젝트나 사용자의 변화에 맞는 조직 전략을 구현할 수 있습니다.

설정 방법

Windsurf

1. Node.js 등 필수 선행 조건을 설치하세요.
2. Windsurf 구성 파일(windsurf.json 등)을 엽니다.
3. Gmail MCP 서버 패키지를 추가하세요:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

4. 저장 후 Windsurf를 재시작하세요.
5. Windsurf 대시보드에서 MCP 서버가 정상 등록되었는지 확인하세요.

API 키 보안 저장 예시:

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "npx",
      "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude

1. Node.js와 Claude 플랫폼을 준비하세요.
2. Claude의 MCP 구성 파일을 편집합니다.
3. Gmail MCP 서버를 추가하세요:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

4. 저장 후 Claude를 재시작하세요.
5. Claude 내에서 서버가 활성화되었는지 확인하세요.

환경 변수 예시:

{
  "env": {
    "GOOGLE_CLIENT_ID": "your-client-id",
    "GOOGLE_CLIENT_SECRET": "your-client-secret"
  }
}

Cursor

1. Node.js를 설치하고 Cursor가 정상 실행 중인지 확인하세요.
2. Cursor 구성 파일에 Gmail MCP 서버를 추가하세요:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

3. 변경 사항을 적용하려면 Cursor를 재시작하세요.
4. MCP 서버 목록에서 연결이 확인되는지 점검하세요.

Cline

1. Node.js 환경을 준비하세요.
2. Cline 구성 파일에 Gmail MCP 서버 항목을 추가하세요:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

3. 저장 후 Cline을 재시작하세요.
4. 인터페이스에서 Gmail MCP 서버가 인식되는지 확인하세요.

참고:
API 키와 같은 민감한 자격증명은 항상 환경 변수로 저장하고, 구성 파일에 직접 입력하지 마세요. MCP 서버 구성의 env 속성을 통해 안전하게 주입하세요.

FlowHunt 워크플로우에서 MCP 사용법

FlowHunt에서 MCP 서버를 워크플로우에 통합하려면, 먼저 MCP 컴포넌트를 플로우에 추가하고 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭하면 설정 패널이 열립니다. 시스템 MCP 구성 섹션에 다음과 같은 JSON 형식으로 MCP 서버 정보를 입력하세요:

{
  "gmail-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

구성이 완료되면 AI 에이전트가 MCP의 모든 기능을 도구로 사용할 수 있습니다. “gmail-mcp"는 실제 MCP 서버 이름으로, URL은 본인의 MCP 서버 주소로 변경해야 합니다.

개요

공개 문서를 기준으로 Gmail MCP 서버는 Gmail 워크플로우 자동화 및 통합 측면에서 기능이 충분히 제공되나, 명시적 프롬프트 템플릿과 샘플링/roots 지원 문서는 부족합니다. 보안 처리와 도구/리소스 노출은 우수하여 완성도 및 개발자 준비도는 10점 만점에 7.5점으로 평가합니다.

MCP 점수