MCP Reference: gmailmcp.googleapis.com

이는 Gmail API에서 제공하는 MCP 서버입니다. 서버는 개발자가 Gmail을 기반으로 LLM 애플리케이션을 빌드할 수 있는 도구를 제공합니다.

모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 AI 애플리케이션이 이해할 수 있는 형식으로 응답을 변환합니다.

서버 설정

사용하기 전에 Gmail MCP 서버를 구성해야 합니다. Google 및 Google Cloud 원격 MCP 서버 사용에 대한 자세한 내용은 Google Cloud MCP 서버 개요를 참고하세요.

서버 엔드포인트

MCP 서비스 엔드포인트는 AI 애플리케이션 (MCP 클라이언트의 호스트)이 보안 표준 연결을 설정하는 데 사용하는 MCP 서버의 네트워크 주소 및 통신 인터페이스 (일반적으로 URL)입니다. LLM이 컨텍스트를 요청하거나, 도구를 호출하거나, 리소스에 액세스할 때 사용하는 연락처입니다. Google MCP 엔드포인트는 전역 또는 리전일 수 있습니다.

Gmail API MCP 서버에는 다음과 같은 전역 MCP 엔드포인트가 있습니다.

  • https://gmailmcp.googleapis.com/mcp/v1

MCP 도구

MCP 도구는 MCP 서버가 LLM 또는 AI 애플리케이션에 노출하여 실제 작업을 실행하는 함수 또는 실행 가능한 기능입니다.

도구

gmailmcp.googleapis.com MCP 서버에는 다음과 같은 도구가 있습니다.

MCP 도구
create_draft

인증된 사용자의 Gmail 계정에 새 이메일 초안을 만듭니다.

이 도구는 수신자 주소, 제목, 본문 콘텐츠를 입력으로 사용합니다. 생성된 Gmail 초안의 ID를 반환합니다.
list_drafts

인증된 사용자의 Gmail 계정에서 임시 이메일을 나열합니다.

이 도구는 쿼리 문자열을 기반으로 초안을 필터링할 수 있으며 페이지로 나누기를 지원합니다. ID와 제목을 포함한 초안 목록을 반환합니다.
get_thread 인증된 사용자의 Gmail 계정에서 특정 이메일 대화목록을 가져옵니다. 메시지 목록이 포함됩니다.
search_threads

인증된 사용자의 Gmail 계정에서 이메일 대화목록을 나열합니다.

이 도구는 쿼리 문자열을 기반으로 대화목록을 필터링할 수 있으며 페이지로 나누기를 지원합니다. ID와 관련 메시지를 포함한 대화목록 목록을 반환합니다. 각 관련 메시지에는 메시지 본문의 스니펫, 제목, 발신자, 수신자 등의 세부정보가 포함됩니다. 이 도구는 전체 메일 본문을 반환하지 않습니다. 필요한 경우 스레드 ID와 함께 'get_thread' 도구를 사용하여 전체 메일 본문을 가져오세요.
label_thread

인증된 사용자의 Gmail 계정에 있는 전체 대화목록에 라벨을 추가합니다. 이 작업은 현재 대화목록에 있는 모든 메시지와 향후 추가되는 메시지에 영향을 미칩니다.

스레드 ID를 잘 모르는 경우 먼저 search_threads 도구를 사용하세요.

사용자 라벨의 ID를 잘 모르는 경우 먼저 list_labels 도구를 사용하여 사용 가능한 라벨과 ID를 확인하세요.
unlabel_thread 인증된 사용자의 Gmail 계정에서 전체 대화목록의 라벨을 삭제합니다. 스레드 ID를 잘 모르는 경우 먼저 search_threads 도구를 사용하세요. 사용자 라벨의 ID를 잘 모르는 경우 먼저 list_labels 도구를 사용하세요.
list_labels 인증된 사용자의 Gmail 계정에서 사용할 수 있는 모든 사용자 정의 라벨을 나열합니다. label_thread, unlabel_thread, label_message 또는 unlabel_message를 호출하기 전에 이 도구를 사용하여 사용자 라벨의 id를 검색하세요. 시스템 라벨은 이 도구에서 반환되지 않지만 잘 알려진 ID(예: 'INBOX', 'TRASH', 'SPAM', 'STARRED', 'UNREAD', 'IMPORTANT', 'CHAT', 'DRAFT', 'SENT')와 함께 사용할 수 있습니다.
label_message

인증된 사용자의 Gmail 계정에 있는 특정 메일에 하나 이상의 라벨을 추가합니다.

메시지 ID를 찾으려면 search_threads 또는 get_thread과 같은 도구를 사용하세요. 사용자 라벨의 ID를 잘 모르는 경우 먼저 list_labels 도구를 사용하여 사용 가능한 라벨과 ID를 확인하세요.
unlabel_message 인증된 사용자의 Gmail 계정에서 특정 메일의 하나 이상의 라벨을 삭제합니다. 메시지 ID를 찾으려면 search_threads 또는 get_thread과 같은 도구를 사용하세요. 사용자 라벨의 ID를 잘 모르는 경우 먼저 list_labels 도구를 사용하여 사용 가능한 라벨과 ID를 확인하세요.
create_label 인증된 사용자의 Gmail 계정에 새 라벨을 만듭니다.

MCP 도구 사양 가져오기

MCP 서버의 모든 도구에 대한 MCP 도구 사양을 가져오려면 tools/list 메서드를 사용하세요. 다음 예시에서는 curl을 사용하여 MCP 서버 내에서 현재 사용할 수 있는 모든 도구와 사양을 나열하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'