Gmail 플러그인 MCP 서버

Gmail 통합을 지원하는 강력한 MCP 서버로, MCP 클라이언트를 통해 이메일을 직접 관리할 수 있습니다. 이 플러그인은 이메일 읽기, 전송, 관리 등 Gmail의 핵심 기능에 원활하게 액세스할 수 있도록 해줍니다.

참고 : uvx를 사용한 샘플 MCP 서버 구현은 이 예제 에서 확인하세요.

🎥 데모

https://github.com/user-attachments/assets/df9e86cf-1f6b-4265-9c68-b3ed88103d1f

✨ 특징

📧 이메일 보내기 및 받기
📥 읽지 않은 메시지 읽기
🗑️ 이메일 휴지통에 버리기
📱 브라우저에서 이메일 열기
📝 이메일을 읽음으로 표시
🔒 안전한 OAuth2 인증

🚀 빠른 시작

필수 조건

Python 3.12 이상
Gmail API 자격 증명
MCP 클라이언트(Claude Desktop과 유사)

설치

저장소를 복제합니다.

지엑스피1

종속성 설치(방법 하나 선택):

# Method 1: Install in editable mode
uv pip install -e .

# Method 2: Install using requirements.txt
uv pip install -r requirements.txt

# Method 3: Install using uv sync (recommended)
uv sync --dev --all-extras

Gmail API 자격 증명을 구성하세요.
- Google Cloud Console 로 이동
- 새 프로젝트를 생성하거나 기존 프로젝트를 선택하세요
- Gmail API 활성화
- OAuth 동의 화면 구성:
  - "외부" 사용자 유형을 선택하세요(게시 필요 없음)
  - 대상자 탭으로 이동: 이메일을 "테스트 사용자"로 추가하세요.
  - OAuth 범위 추가: https://www.googleapis.com/auth/gmail/modify
- OAuth 2.0 자격 증명을 만듭니다.
  - 애플리케이션 유형으로 "데스크톱 앱"을 선택하세요
  - JSON 자격 증명 파일을 다운로드하세요
- 자격 증명 파일을 저장하고 절대 경로를 기록해 둡니다( --creds-file-path 에 사용됨)

구성

개발/미공개 서버용

MCP 클라이언트 구성에 다음을 추가하세요.

"mcpServers": {
  "gmail-plugin": {
    "command": "uv",
    "args": [
      "--directory",
      "[absolute path to working directory]",
      "run",
      "server.py"
      "--creds-file-path",
      "[absolute-path-to-credentials-file]",
      "--token-path",
      "[absolute-path-to-access-tokens-file]"
    ]
  }
}

게시된 서버의 경우

"mcpServers": {
  "gmail-plugin": {
    "command": "uvx",
    "args": [
      "gmail-plugin"
    ]
  }
}

🛠️ 개발

건축 및 출판

동기화 종속성:

uv sync

패키지 빌드:

uv build

PyPI에 게시:

uv publish

디버깅

디버깅을 위해 MCP Inspector를 사용하세요.

npx @modelcontextprotocol/inspector uv --directory C:\Users\sanch\Desktop\gmail_plugin\gmail-plugin run gmail-plugin

📚 API 참조

사용 가능한 도구

도구 이름	설명	필수 인수
`send-email`	이메일 보내기	수신자 ID, 제목, 메시지
`get-unread-emails`	읽지 않은 이메일 검색	없음
`read-email`	이메일 내용 읽기	이메일_아이디
`trash-email`	이메일을 휴지통으로 이동	이메일_아이디
`mark-email-as-read`	이메일을 읽음으로 표시	이메일_아이디
`open-email`	브라우저에서 이메일 열기	이메일_아이디

사용 가능한 프롬프트

프롬프트 이름	설명	인수
`manage-email`	이메일 관리자 역할 수행	없음
`draft-email`	새 이메일 초안 작성	내용, 수신자, 수신자_이메일
`edit-draft`	기존 이메일 초안 편집	변경 사항, current_draft

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

Gmail Plugin MCP Server

Integrations