MCP 지메일

Gmail 통합을 위한 모델 컨텍스트 프로토콜 서버입니다. 이를 통해 Claude Desktop(또는 모든 MCP 클라이언트)이 Google Apps Script를 통해 Gmail 계정과 상호 작용할 수 있습니다.

빠른 시작(사용자용)

필수 조건

• Node.js 18+ ( brew install node 통해 설치)

• Gmail 계정

• Google Apps Script 배포

• Claude Desktop( https://claude.ai/desktop 에서 설치)

구성

1. Google Apps Script 배포

• Google Apps Script를 방문하여 새 프로젝트를 만드세요.

• code.gs 의 전체 내용을 복사하여 스크립트 편집기에 붙여넣습니다.

• "배포" > "새 배포"를 클릭하세요.

• 배포 유형으로 "웹 앱"을 선택하세요

• 다음 설정을 구성하세요.

  • 실행자: 나

  • 접근 권한이 있는 사람: 누구나

  • "배포"를 클릭하세요

• 메시지가 표시되면 앱을 검토하고 Gmail 계정에 액세스할 수 있도록 승인하세요.

• 배포 URL을 복사하고 보안을 위해 무작위 API 키를 생성합니다.

참고: 이 스크립트에는 Gmail 액세스 권한이 필요합니다. 스크립트를 처음 배포하고 실행할 때 Google에서 이러한 권한을 검토하고 부여해 달라고 요청합니다. 다음 사항을 확인하세요.

1. "권한 검토"를 클릭하세요

2. Google 계정을 선택하세요

3. 경고가 표시되면 "고급"을 클릭하세요.

4. "[프로젝트 이름]으로 이동(안전하지 않음)"을 클릭하세요.

5. "허용"을 클릭하여 필요한 Gmail 권한을 부여하세요.

6. ~/Library/Application Support/Claude/claude_desktop_config.json 에서 Claude Desktop 구성 파일을 엽니다.

Claude Desktop 메뉴를 통해 이 기능을 찾을 수 있습니다.

1. 클로드 데스크톱 열기

2. Mac 메뉴 막대에서 Claude를 클릭하세요

3. "설정"을 클릭하세요

4. "개발자"를 클릭하세요

5. 구성에 다음을 추가하세요.

지엑스피1

참고: YOUR_DEPLOYMENT_URL 과 YOUR_API_KEY 실제 값으로 바꾸세요.

Related MCP server: Gmail API MCP Server

개발자를 위한

필수 조건

• Node.js 18+ ( brew install node 통해 설치)

• Gmail 계정

• 구글 앱 스크립트

• Claude Desktop( https://claude.ai/desktop 에서 설치)

• tsx ( npm install -g tsx 를 통해 설치)

설치

git clone https://github.com/kazuph/mcp-gmail-gas.git
cd mcp-gmail-gas
npm install
npm run build

개발 구성

1. Claude Desktop이 설치되어 실행 중인지 확인하세요.

2. 아직 설치하지 않았다면 tsx를 전역적으로 설치하세요.

npm install -g tsx
# or
pnpm add -g tsx

3. ~/Library/Application Support/Claude/claude_desktop_config.json 에 있는 Claude Desktop 구성을 수정하세요.

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

{
  "tools": {
    "gmail": {
      "args": ["tsx", "/path/to/mcp-gmail-gas/index.ts"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

사용 가능한 도구

• gmail_search_messages : Gmail 검색 쿼리 구문을 사용하여 이메일을 검색합니다(예: "subject:Meeting newer_than:1d").

• gmail_get_message : 특정 이메일의 전체 내용과 세부 정보를 가져옵니다.

• gmail_download_attachment : 특정 이메일에서 첨부 파일을 다운로드합니다.

보안 참고 사항

VALID_API_KEY 는 항상 비밀로 유지하고 버전 관리 시스템에 절대 공개하지 마세요. 이 키는 권한이 있는 클라이언트만 Google Apps Script 배포를 통해 Gmail에 액세스할 수 있도록 하는 데 도움이 됩니다.