shinzo-labs/gmail-mcp

Gmail MCP 서버

Gmail API에 대한 Model Context Protocol (MCP) 서버 구현은 이메일 관리, 전송 및 검색을위한 표준화 된 인터페이스를 제공합니다.

특징

• 메시지, 스레드, 라벨, 초안 및 설정 포함 Gmail API 적용 완료
• 이메일 발송, 초안 및 관리 지원
• customizable 색깔과 시정 조정을 가진 상표 관리
• 대화 관리를위한 스레드 작업
• 휴가 응답자, IMAP/POP 및 언어 설정을 포함한 설정 관리
• mailbox 변경을 위한 History 추적
• Google Cloud 자격 증명을 사용하여 OAuth2 인증 획득

필수품

종점

간단한 설치를 위해 Node.js 18+를 설치하십시오. 로컬을 구축하고 싶다면 pnpm을 설치해야합니다.

구글 워크스페이스 설정

이 MCP 서버를 실행하려면 조직의 Google API 클라이언트를 설정해야합니다. 각 사용자는 자신의 OAuth 새로 고침 토큰을 검색하기 위해 스크립트를 실행합니다.

구글 API 클라이언트 설정 (단체당 온스)

1. Google Cloud 콘솔로 이동.
2. 새로운 프로젝트를 만들거나 기존의 것을 선택하십시오.
3. 프로젝트에 대한 Gmail API를 사용.
4. 명세.

A Model Context Protocol (MCP) server implementation for the Gmail API, providing a standardized interface for email management, sending, and retrieval.

Features

• Complete Gmail API coverage including messages, threads, labels, drafts, and settings
• Support for sending, drafting, and managing emails
• Label management with customizable colors and visibility settings
• Thread operations for conversation management
• Settings management including vacation responder, IMAP/POP, and language settings
• History tracking for mailbox changes
• Secure OAuth2 authentication using Google Cloud credentials

Prerequisites

Dependencies

For simplest installation, install Node.js 18+. If you would like to build locally, you will also need to install pnpm.

Google Workspace Setup

To run this MCP server, you will need to set up a Google API Client for your organization, with each user running a script to retrieve their own OAuth refresh token.

Google API Client Setup (once per organization)

1. Go to the Google Cloud Console.
2. Create a new project or select an existing one.
3. Enable the Gmail API for your project.
4. Go to Credentials and create an OAuth 2.0 Client ID. Choose “Desktop app” for the client type.
5. Download and save the OAuth keys JSON as ~/.gmail-mcp/gcp-oauth.keys.json. ⚠️ NOTE: to create ~/.gmail-mcp/ through MacOS’s Finder app you need to enable hidden files first.
6. (Optional) For remote server installation (ex. using Smithery CLI), note the CLIENT_ID and CLIENT_SECRET from this file.