Skip to main content
Glama
Sign In
enesjakozh

Gmail MCP Server

by Quantum-369
GitHub
Python
Apache 2.0
8
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Allows reading, sending, and managing emails from multiple Gmail accounts, including searching emails, downloading attachments, and handling email conversations and threads.

  • Requires a Google Cloud Project with Gmail API enabled and OAuth 2.0 credentials for authentication and authorization.

Gmail MCP 서버

MCP(Message Control Protocol) 프레임워크를 기반으로 구축된 강력하고 유연한 Gmail 통합 서버입니다. 이 서버는 Gmail API와 연동할 수 있는 강력한 인터페이스를 제공하여 프로그래밍 방식으로 이메일을 읽고, 보내고, 관리하는 기능을 제공합니다.

특징

  • 여러 Gmail 계정에서 이메일 읽기
  • 첨부 파일이 있는 이메일 보내기
  • 고급 쿼리 옵션을 사용하여 이메일 검색
  • 이메일 첨부 파일 다운로드
  • 이메일 대화 및 스레드 처리
  • 실시간 이메일 모니터링
  • 여러 Gmail 계정 지원

필수 조건

Gmail MCP 서버를 실행하기 전에 다음 사항이 있는지 확인하세요.

  1. Python 3.12 이상
  2. Gmail API가 활성화된 Google Cloud 프로젝트
  3. OAuth 2.0 클라이언트 ID 자격 증명
  4. 필수 Python 패키지(pyproject.toml에 지정됨)

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Gmail 통합 서버를 자동으로 설치하려면:

지엑스피1

  1. 저장소를 복제합니다.
git clone <your-repository-url> cd gmail-mcp-server
  1. 가상 환경을 만들고 활성화하세요.
python -m venv venv # On Windows venv\Scripts\activate # On Unix/MacOS source venv/bin/activate
  1. 종속성 설치:
pip install .

Google Cloud 프로젝트 설정

  1. Google Cloud Console 로 이동
  2. 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
  3. 프로젝트에 Gmail API를 활성화하세요
  4. OAuth 2.0 자격 증명을 만듭니다.
    • "API 및 서비스" > "자격 증명"으로 이동하세요.
    • "자격 증명 만들기" > "OAuth 클라이언트 ID"를 클릭하세요.
    • 애플리케이션 유형으로 "데스크톱 앱"을 선택하세요
    • 클라이언트 구성 파일을 다운로드하세요
  5. 다운로드한 파일의 이름을 client_secret.json 으로 바꾸고 프로젝트 루트 디렉토리에 넣으세요.

구성

  1. gmail_token_creator.py 에 이메일 식별자를 설정합니다.
email_identifier = 'your.email@gmail.com' # Change this for each account
  1. Gmail 계정을 인증하려면 토큰 생성기를 실행하세요.
python gmail_token_creator.py
  1. 통합하려는 각 Gmail 계정에 대해 프로세스를 반복하세요.

서버 구조

  • gmail_server.py : 주요 MCP 서버 구현
  • gmail_api.py : Gmail API 상호작용 함수
  • google_apis.py : Google API 인증 유틸리티
  • 지원 파일:
    • read_emails.py : 이메일 읽기 기능
    • search_emails.py : 이메일 검색 기능
    • send_emails.py : 이메일 전송 기능

용법

서버 시작

python gmail_server.py

사용 가능한 도구

  1. 이메일 보내기:
await send_gmail( email_identifier="your.email@gmail.com", to="recipient@example.com", subject="Test Subject", body="Email body content", attachment_paths=["path/to/attachment"] )
  1. 이메일 검색:
await search_email_tool( email_identifier="your.email@gmail.com", query="from:someone@example.com", max_results=30, include_conversations=True )
  1. 최신 이메일 읽기:
await read_latest_emails( email_identifier="your.email@gmail.com", max_results=5, download_attachments=False )
  1. 첨부 파일 다운로드:
await download_email_attachments( email_identifier="your.email@gmail.com", msg_id="message_id", download_all_in_thread=False )

보안 고려 사항

  • client_secret.json 안전하게 저장하고 버전 제어에 커밋하지 마십시오.
  • 토큰 파일을 안전하게 보관하고 .gitignore 에 추가하세요.
  • 민감한 정보에는 환경 변수를 사용하세요
  • 정기적으로 OAuth 자격 증명을 순환합니다.
  • API 사용량을 모니터링하고 적절한 할당량을 설정합니다.

오류 처리

서버에는 포괄적인 오류 처리 및 로깅이 포함되어 있습니다.

  • 로그는 gmail_mcp.log 에 기록됩니다.
  • 파일 및 콘솔 로깅이 모두 활성화되었습니다.
  • 디버깅을 위한 자세한 오류 메시지

기여하다

  1. 저장소를 포크하세요
  2. 기능 브랜치 생성
  3. 변경 사항을 커밋하세요
  4. 지점으로 밀어 넣기
  5. 풀 리퀘스트 만들기

특허

아파치 라이선스 2.0

지원하다

문제 및 기능 요청은 GitHub 문제 추적기를 이용하세요.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Gmail API를 통해 Gmail과 연동하여 이메일을 읽고, 보내고, 관리할 수 있습니다. 실시간 모니터링과 이메일 검색 및 첨부 파일 처리를 위한 고급 기능을 갖춘 여러 Gmail 계정을 지원합니다.

  1. 특징
    1. 필수 조건
      1. 설치
        1. Smithery를 통해 설치
      2. Google Cloud 프로젝트 설정
        1. 구성
          1. 서버 구조
            1. 용법
              1. 서버 시작
              2. 사용 가능한 도구
            2. 보안 고려 사항
              1. 오류 처리
                1. 기여하다
                  1. 특허
                    1. 지원하다

                      Related Resources

                      Related MCP Servers

                      • Systemprompt MCP Gmail Server

                        Ejb503
                        -
                        security
                        F
                        license
                        -
                        quality
                        Enables users to manage Gmail accounts using AI agent-assisted operations via an MCP protocol, supporting email search, reading, deletion, and sending with a voice-powered interface.
                        Last updated -
                        2
                        5
                        TypeScript

                      • Gmail MCP Server

                        jmonsellier
                        -
                        security
                        A
                        license
                        -
                        quality
                        Integrates with Gmail to enable sending, reading, drafting, and managing emails via the Model Context Protocol (MCP), allowing users to interact with email tasks through automated client prompts.
                        Last updated -
                        Python
                        GPL 3.0

                      • Gmail Plugin MCP Server

                        sanchisingh01
                        -
                        security
                        A
                        license
                        -
                        quality
                        An MCP server that enables Gmail integration, allowing users to manage emails (send, receive, read, trash, mark as read) directly through MCP clients like Claude Desktop.
                        Last updated -
                        Python
                        MIT License

                      • Gmail MCP

                        fourdots
                        -
                        security
                        F
                        license
                        -
                        quality
                        Enables AI assistants to interact with Gmail accounts via IMAP, allowing them to list, search, read, and send emails, manage labels and folders, and access attachments through the Model Context Protocol.
                        Last updated -
                        Python
                        • Linux
                        • Apple

                      View all related MCP servers

                      Appeared in Searches

                      ID: mkugelscaj