Gmail 플러그인 MCP 서버

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

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

🎥 데모

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

Related MCP server: mcp-gmail

✨ 특징

• 📧 이메일 보내기 및 받기

• 📥 읽지 않은 메시지 읽기

• 🗑️ 이메일 휴지통에 버리기

• 📱 브라우저에서 이메일 열기

• 📝 이메일을 읽음으로 표시

• 🔒 안전한 OAuth2 인증

🚀 빠른 시작

필수 조건

• Python 3.12 이상

• Gmail API 자격 증명

• MCP 클라이언트(Claude Desktop과 유사)

설치

1. 저장소를 복제합니다.

지엑스피1

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

# 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

3. 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"
    ]
  }
}

🛠️ 개발

건축 및 출판

1. 동기화 종속성:

uv sync

2. 패키지 빌드:

uv build

3. PyPI에 게시:

uv publish

디버깅

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

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

📚 API 참조

사용 가능한 도구

사용 가능한 프롬프트

🤝 기여하기

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

📄 라이센스

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