A
securityA
licenseA
qualityModel Context Protocol server for Gmail integration. This allows Claude Desktop (or any MCP client) to interact with your Gmail account through Google Apps Script.
Last updated -
3
666
11
JavaScript
MIT License
모델 컨텍스트 프로토콜(MCP)을 위한 Gmail 서버
이 MCP 서버는 Gmail과 통합되어 이메일을 보내고, 삭제하고, 읽고, 초안을 작성하고, 답장할 수 있습니다.
참고: 이 서버를 통해 MCP 클라이언트는 이메일을 읽고, 삭제하고, 보낼 수 있습니다. 단, 클라이언트는 이러한 작업을 수행하기 전에 사용자에게 확인 메시지를 표시합니다.
https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90
구성 요소
도구
- 이메일 보내기
- 이메일 주소 수신자에게 이메일을 보냅니다.
- 입력:
recipient_id(문자열): 수신자의 이메일 주소subject(문자열): 이메일 제목message(문자열): 이메일 내용
- 상태 및 message_id를 반환합니다.
- 휴지통 이메일
- 이메일을 휴지통으로 이동합니다
- 입력:
email_id(문자열): 이메일의 자동 생성 ID
- 성공 메시지를 반환합니다.
- 이메일을 읽음으로 표시
- 이메일을 읽음으로 표시
- 입력:
email_id(문자열): 이메일의 자동 생성 ID
- 성공 메시지를 반환합니다.
- 읽지 않은 이메일 가져오기
- 읽지 않은 이메일을 검색합니다
- 이메일 ID를 포함한 이메일 목록을 반환합니다.
- 이메일 읽기
- 주어진 이메일 내용을 검색합니다
- 입력:
email_id(문자열): 이메일의 자동 생성 ID
- 이메일 메타데이터 사전을 반환하고 이메일을 읽음으로 표시합니다.
- 오픈 이메일
- 브라우저에서 이메일 열기
- 입력:
email_id(문자열): 이메일의 자동 생성 ID
- 성공 메시지를 반환하고 기본 브라우저에서 제공된 이메일을 엽니다.
설정
Gmail API 설정
- 새로운 Google Cloud 프로젝트를 만듭니다.
- Gmail API 활성화
- OAuth 동의 화면 구성
- "외부"를 선택하세요. 하지만 앱은 게시되지 않습니다.
- "테스트 사용자"로 개인 이메일 주소를 추가하세요.
- OAuth 범위 추가
https://www.googleapis.com/auth/gmail/modify - "데스크톱 앱" 애플리케이션 유형에 대한 OAuth 클라이언트 ID를 만듭니다.
- 클라이언트의 OAuth 키 JSON 파일을 다운로드하세요.
- 키 파일의 이름을 변경하고 로컬 컴퓨터의 안전한 위치에 저장하세요. 저장 위치를 기록해 두세요.
- 서버가 시작되면 이 파일의 절대 경로가
--creds-file-path매개변수로 전달됩니다.
- 서버가 시작되면 이 파일의 절대 경로가
입증
서버가 시작되면 시스템 브라우저에서 인증 흐름이 시작됩니다. 토큰 자격 증명은 --token-path 매개변수에 전달된 절대 파일 경로에 저장되고 나중에 검색됩니다.
예를 들어, [your-home-folder] .를 대체하여 홈 폴더에 도트 디렉토리를 사용할 수 있습니다.
| 매개변수 | 예 |
|---|---|
--creds-file-path | /[your-home-folder]/.google/client_creds.json |
--token-path | /[your-home-folder]/.google/app_tokens.json |
데스크톱 앱 사용
uv를 사용하는 것이 좋습니다.
이 서버를 MCP 클라이언트로 Claude Desktop과 통합하려면 앱의 서버 구성에 다음을 추가하세요. 기본적으로 이 설정은 ~/Library/Application\ Support/Claude/claude_desktop_config.json 에 저장됩니다.
지엑스피1
다음 매개변수를 설정해야 합니다.
| 매개변수 | 예 |
|---|---|
--directory | 서버가 포함된 gmail 디렉토리의 절대 경로 |
--creds-file-path | Gmail API 설정에서 생성된 자격 증명 파일의 절대 경로입니다. |
--token-path | 애플리케이션의 액세스 토큰과 새로 고침 토큰을 저장하고 검색하기 위한 절대 경로입니다. |
MCP Inspector를 사용한 문제 해결
서버를 테스트하려면 MCP Inspector를 사용하세요. git 저장소에서 아래 명령어를 실행하여 매개변수 인수를 적절히 변경하세요.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Gmail과 통합되어 Model Context Protocol(MCP)을 통해 이메일을 보내고, 읽고, 초안을 작성하고, 관리할 수 있으며, 사용자는 자동화된 클라이언트 프롬프트를 통해 이메일 작업과 상호 작용할 수 있습니다.
Related Resources
Related MCP Servers
- -securityAlicense-qualityEnables interaction with Gmail and Google Calendar using the MCP protocol, supporting multiple Google accounts, email management, and calendar operations through natural language.Last updated -12TypeScriptMIT License
- -securityAlicense-qualityProvides comprehensive Gmail integration with LLM processing capabilities, allowing users to read, search, filter emails and handle attachments through the Model Context Protocol.Last updated -111TypeScriptMIT License
- -securityAlicense-qualityMCP server that integrates with Gmail to enable sending, reading, and managing emails through tools like send-email, trash-email, get-unread-emails, and read-email.Last updated -56PythonGPL 3.0