Gmail MCP

Claude가 귀하의 Gmail 계정에서 이메일을 검색하고 가져올 수 있도록 허용합니다.

설정

1. Google API 자격 증명 받기

1. Google Cloud Console을 방문하세요

2. 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요

3. 프로젝트에 Gmail API를 활성화하세요

   • "API 및 서비스" > "라이브러리"로 이동합니다.

   • "Gmail API"를 검색하여 활성화하세요.

4. OAuth 자격 증명을 만듭니다.

   • "API 및 서비스" > "자격 증명"으로 이동하세요.

   • "자격 증명 만들기" > "OAuth 클라이언트 ID"를 클릭하세요.

   • 응용 프로그램 유형으로 "데스크톱 응용 프로그램"을 선택하세요

   • 클라이언트 이름을 지정하고 "만들기"를 클릭하세요.

5. 자격 증명 JSON 파일을 다운로드하세요

6. 프로젝트 디렉토리에 credentials.json 으로 저장하세요.

2. 애플리케이션 승인

토큰을 생성하려면 인증 명령을 실행하세요.

지엑스피1

브라우저 창이 열리면 Google 계정에 로그인하여 필요한 권한을 부여해야 합니다. 권한이 부여되면 프로젝트 디렉터리에 token.json 파일이 생성됩니다.

Related MCP server: Gmail MCP Server

Claude로 구성하기

Claude 구성 파일에 Gmail MCP 서버를 추가합니다.

{
  "mcpServers": {
    "gmail": {
      "args": [
        "--from",
        "git+https://github.com/vinayak-mehta/gmail-mcp",
        "gmail-mcp"
      ],
      "command": "/Users/username/.local/bin/uvx",
      "env": {
        "GMAIL_CREDS_PATH": "/Users/username/path/to/gmail-mcp/credentials.json",
        "GMAIL_TOKEN_PATH": "/Users/username/path/to/gmail-mcp/token.json"
      }
    }
  }
}

다음 사항을 확인하세요.

• /Users/username/path/to/gmail-mcp 실제 프로젝트 경로로 바꾸세요.

• 설치된 uvx 실행 파일의 command 경로를 조정하세요.

• credentials.json 및 token.json 파일에 대한 올바른 경로를 제공하세요.

이제 클로드는 다음 도구에 액세스할 수 있습니다.

1. 이메일 검색

Gmail 계정에서 이메일을 검색하세요.

예시 프롬프트: " example@gmail.com 에서 온 모든 이메일을 검색하세요"

2. 이메일 콘텐츠 가져오기

특정 이메일의 전체 내용을 검색합니다.

예시 프롬프트: "제목이 '내일 회의'인 이메일의 전체 내용을 보여주세요"

3. 메시지 목록

Gmail 받은 편지함의 최근 메시지를 나열합니다.

예시 프롬프트: "가장 최근의 이메일 5개를 나열하세요"

환경 변수

환경 변수를 사용하여 자격 증명 및 토큰 파일의 경로를 구성할 수 있습니다.

• GMAIL_CREDS_PATH : credentials.json 파일의 경로

• GMAIL_TOKEN_PATH : token.json 파일의 경로

쉽게 구성할 수 있도록 프로젝트 루트에 이러한 변수가 포함된 .env 파일을 만듭니다.