Gmail 플러그인 MCP 서버

파이썬 버전

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

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

🎥 데모

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

Related MCP server: @kazuph/mcp-gmail-gas

✨ 특징

📧 이메일 보내기 및 받기
📥 읽지 않은 메시지 읽기
🗑️ 이메일 휴지통에 버리기
📱 브라우저에서 이메일 열기
📝 이메일을 읽음으로 표시
🔒 안전한 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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Gmail Plugin MCP Server