모델 컨텍스트 프로토콜(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
성공 메시지를 반환하고 기본 브라우저에서 제공된 이메일을 엽니다.
Related MCP server: MCP Google Workspace Server
설정
Gmail API 설정
"외부"를 선택하세요. 하지만 앱은 게시되지 않습니다.
"테스트 사용자"로 개인 이메일 주소를 추가하세요.
OAuth 범위 추가
https://www.googleapis.com/auth/gmail/modify"데스크톱 앱" 애플리케이션 유형에 대한 OAuth 클라이언트 ID를 만듭니다.
클라이언트의 OAuth 키 JSON 파일을 다운로드하세요.
키 파일의 이름을 변경하고 로컬 컴퓨터의 안전한 위치에 저장하세요. 저장 위치를 기록해 두세요.
서버가 시작되면 이 파일의 절대 경로가
--creds-file-path매개변수로 전달됩니다.
입증
서버가 시작되면 시스템 브라우저에서 인증 흐름이 시작됩니다. 토큰 자격 증명은 --token-path 매개변수에 전달된 절대 파일 경로에 저장되고 나중에 검색됩니다.
예를 들어, [your-home-folder] .를 대체하여 홈 폴더에 도트 디렉토리를 사용할 수 있습니다.
매개변수 | 예 |
|
|
|
|
데스크톱 앱 사용
uv를 사용하는 것이 좋습니다.
이 서버를 MCP 클라이언트로 Claude Desktop과 통합하려면 앱의 서버 구성에 다음을 추가하세요. 기본적으로 이 설정은 ~/Library/Application\ Support/Claude/claude_desktop_config.json 에 저장됩니다.
지엑스피1
다음 매개변수를 설정해야 합니다.
매개변수 | 예 |
| 서버가 포함된
디렉토리의 절대 경로 |
| Gmail API 설정에서 생성된 자격 증명 파일의 절대 경로입니다. |
| 애플리케이션의 액세스 토큰과 새로 고침 토큰을 저장하고 검색하기 위한 절대 경로입니다. |
MCP Inspector를 사용한 문제 해결
서버를 테스트하려면 MCP Inspector를 사용하세요. git 저장소에서 아래 명령어를 실행하여 매개변수 인수를 적절히 변경하세요.