헤드리스 Gmail MCP 서버

“헤드리스 Gmail” MCP 서버란 무엇을 하나요?

헤드리스 Gmail MCP 서버는 Model Context Protocol(MCP) 서버로, 로컬 자격 증명이나 토큰 설정 없이 Gmail 계정과의 원활한 이메일 송수신 및 관리를 가능하게 합니다. 헤드리스 및 원격 환경에서 동작하도록 설계되어, 클라이언트가 OAuth 인증 과정을 독립적으로 수행하고 자격 증명을 안전하게 컨텍스트로 전달할 수 있어, 로컬 파일 접근이나 브라우저 상호작용 없이 완전히 컨테이너화된 환경이나 클라우드 환경에서 운영할 수 있습니다. 이 서버는 마케팅 자동화나 알림 시스템 등, 집중적이고 신뢰성 높은 Gmail 접근이 필요한 워크플로우에 이상적이며, MCP 인터페이스를 통해 표준화된 도구를 노출하여 이메일 관리 및 AI 기반 개발 파이프라인에 손쉽게 통합할 수 있습니다.

프롬프트 목록

저장소에 별도의 프롬프트 템플릿이 언급되어 있지 않습니다.

리소스 목록

공개 문서나 코드에 명시적인 MCP 리소스가 설명되어 있지 않습니다.

도구 목록

• 최근 이메일 가져오기
  Gmail 계정에서 가장 최근의 이메일을 조회하며, 이메일 본문의 앞 1,000자를 반환합니다.
• 전체 이메일 본문 가져오기
  오프셋 파라미터를 사용해 이메일 전체 내용을 1,000자 단위 청크로 가져올 수 있어, 대용량 이메일도 조회가 가능합니다.
• 이메일 전송
  연결된 Gmail 계정을 통해 이메일을 발송합니다.
• 액세스 토큰 갱신
  토큰을 독립적으로 갱신하여, 지속적으로 안전한 접근을 보장합니다.

MCP 서버 활용 예시

• 자동 이메일 알림
  AI 에이전트나 자동화 플랫폼과 연동하여 수동 개입 없이 실시간 이메일 알림을 전송합니다.
• Gmail 인박스 모니터링
  최신 이메일을 자동으로 수집 및 처리하여, 자동 응답·분류·정보 추출 등의 후속 워크플로우를 구성할 수 있습니다.
• 마케팅 캠페인 자동화
  MCP를 이용해 자격 증명이 분리된 상태로 대규모·개인화 마케팅 이메일을 자동으로 전송합니다.
• API 무결성 통합
  개발 환경이나 타 MCP 호환 플랫폼에 Gmail 연산을 통합하여 로컬 자격 증명 노출 없이 활용할 수 있습니다.
• 원격/클라우드 이메일 관리
  도커 기반 혹은 원격 환경에서 Gmail 계정을 관리하여, 로컬 의존성 없이 안전하고 헤드리스하게 운영할 수 있습니다.

설정 방법

Windsurf

1. Node.js와 Windsurf가 설치되어 있는지 확인하세요.
2. 설정 파일(예: windsurf.json)을 엽니다.
3. mcpServers 섹션에 Headless Gmail MCP 서버를 추가합니다:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 변경 사항을 저장하고 Windsurf를 재시작하세요.
5. Windsurf 대시보드에서 서버 실행 상태를 확인하세요.

API 키 보안 설정
환경 변수를 이용해 자격 증명을 안전하게 전달하세요:

{
  "mcpServers": {
    "headless-gmail": {
      "command": "npx",
      "args": ["@baryhuang/mcp-headless-gmail@latest"],
      "env": {
        "GMAIL_CLIENT_ID": "...",
        "GMAIL_CLIENT_SECRET": "...",
        "GMAIL_ACCESS_TOKEN": "...",
        "GMAIL_REFRESH_TOKEN": "..."
      }
    }
  }
}

Claude

1. Claude를 설치하고 Node.js가 준비되어 있는지 확인하세요.
2. 설정 파일(예: claude.json)을 수정하세요.
3. MCP 서버를 추가하세요:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 저장하고 Claude를 재시작하세요.
5. Claude 인터페이스에서 서버 상태를 확인하세요.

API 키 보안 설정
위와 동일하게 env 키를 활용해 자격 증명을 주입하세요.

Cursor

1. Cursor가 설치 및 최신 상태인지 확인하세요.
2. Cursor의 설정 또는 구성 파일을 엽니다.
3. MCP 서버 항목을 추가하세요:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 저장 후 Cursor를 재시작하세요.
5. MCP 서버가 인식되는지 확인하세요.

API 키 보안 설정
앞서 설명한 env 섹션을 사용해 자격 증명을 구성하세요.

Cline

1. Cline 및 필요한 의존성을 설치하세요.
2. Cline 구성 파일을 엽니다.
3. MCP 서버를 추가하세요:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 변경 사항을 저장하고 Cline을 재시작하세요.
5. Cline 도구를 통해 서버 연결 상태를 확인하세요.

API 키 보안 설정
앞서 예시와 같이 환경 변수를 통해 API 자격 증명을 전달하세요.

FlowHunt 워크플로우에서 MCP 사용법

FlowHunt에서 MCP 서버를 워크플로우에 통합하려면, 먼저 MCP 컴포넌트를 플로우에 추가하고 AI 에이전트에 연결하세요:

MCP 컴포넌트를 클릭해 설정 패널을 엽니다. 시스템 MCP 구성 섹션에 아래와 같은 JSON 형식으로 MCP 서버 정보를 입력하세요:

{
  "headless-gmail": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

구성이 완료되면, AI 에이전트는 MCP의 모든 기능과 도구를 사용할 수 있습니다. “headless-gmail"을 실제 MCP 서버명(예: “github-mcp”, “weather-api” 등)으로, URL도 자신이 운영하는 MCP 서버 주소로 바꾸는 것만 잊지 마세요.

개요

의견

제공된 정보를 바탕으로 보면, 헤드리스 Gmail MCP 서버는 초점이 명확하고 대부분의 플랫폼에서 통합이 쉽고, Docker/헤드리스 환경을 튼튼하게 지원합니다. 다만, 명시적인 프롬프트 템플릿이나 리소스 정의가 없어 일부 고급 MCP 기능은 제한될 수 있습니다. 단순성, 보안성, 실제 업무 자동화에 강점이 있으며, 용도에 충실하고 신뢰성 있는 선택이지만 일부 MCP 서버 대비 기능 완성도는 다소 부족할 수 있습니다.

MCP 점수