Gmail MCP Server

MIT License

Integrations

  • Provides access to email content from Gmail accounts using OAuth2 authentication, allowing Claude to read and understand emails while maintaining context and privacy controls.

  • Integrates with Google Cloud Project for Gmail API access, handling authentication and token management for secure access to email data.

Gmail MCP 서버

Gmail을 Claude Desktop과 통합하는 MCP(Model Context Protocol) 서버는 Claude가 적절한 컨텍스트 관리 및 개인정보 보호 제어를 유지하면서 이메일 콘텐츠에 액세스하고 이해할 수 있도록 지원합니다.

특징

  • OAuth2 인증을 통한 Gmail API 통합
  • 안전한 토큰 관리 및 저장
  • 개인 정보 보호 중심 데이터 처리
  • Claude를 위한 컨텍스트 창 관리
  • 포괄적인 로깅 및 오류 처리
  • 간편한 배포를 위한 Docker 지원

필수 조건

  • 노드.js >= 18.0.0
  • npm 또는 yarn
  • Gmail API가 활성화된 Google Cloud 프로젝트
  • 클로드 API 키

설정

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

지엑스피1

  1. 종속성 설치:
npm install
  1. 다음 변수를 사용하여 루트 디렉토리에 .env 파일을 만듭니다.
GOOGLE_CLIENT_ID=your_google_client_id GOOGLE_CLIENT_SECRET=your_google_client_secret GOOGLE_REDIRECT_URI=http://localhost:3000/auth/google/callback CLAUDE_API_KEY=your_claude_api_key PORT=3000
  1. 개발 서버를 시작합니다.
npm run dev

개발

  • npm run dev : 핫 리로딩으로 개발 서버 시작
  • npm test : 테스트 실행
  • npm run lint : ESLint 실행

프로젝트 구조

gmail-mcp-server/ ├── src/ │ ├── server.js # Main server entry point │ ├── auth.js # Authentication handling │ ├── gmail.js # Gmail API integration │ ├── claude.js # Claude API integration │ ├── logger.js # Logging configuration │ └── utils/ # Utility functions ├── tests/ # Test files ├── .env # Environment variables ├── .gitignore # Git ignore rules ├── package.json # Project dependencies └── README.md # Project documentation

기여하다

  1. 저장소를 포크하세요
  2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
  3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
  4. 브랜치에 푸시( git push origin feature/amazing-feature )
  5. 풀 리퀘스트 열기

특허

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

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

Claude Desktop이 적절한 컨텍스트 관리 및 개인정보 보호 제어를 유지하면서 Gmail 콘텐츠에 안전하게 액세스하고 처리할 수 있도록 해주는 통합 서버입니다.

  1. Features
    1. Prerequisites
      1. Setup
        1. Development
          1. Project Structure
            1. Contributing
              1. License
                ID: 89f8mrxo7p