JG

jasonsum/gmail-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

73 stars 37 forks 품질 64 트렌드 14GPL-3.0

jasonsum/gmail-mcp-server는 https://github.com/jasonsum/gmail-mcp-server.]에서 가져온 MCP 서버 후보입니다

개요

jasonsum/gmail-mcp-server는 https://github.com/jasonsum/gmail-mcp-server.]에서 가져온 MCP 서버 후보입니다

개요(AI 번역)

이 MCP 서버는 Gmail과 통합하여 전송, 제거, 읽기, 초안 및 이메일에 응답 할 수 있습니다.

참고: 이 서버는 MCP 클라이언트가 읽고, 제거하고, 이메일을 보냅니다. 그러나 클라이언트는 이러한 활동을 수행하기 전에 사용자를 프롬프트합니다.

https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0]] [T0] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0] [T0] [T0]] [T0] [T0]] [T0] [T0] [T0]] [T0]] [T0] [T0] [T0]] https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90] https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90]]] https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90]]]]]] [[https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90]]]]]]] [[[[[[https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90]]]]]]]]]]]]]] [[[[[[[https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90]]]]]]]]]]]]]]]]]] [[[[[[[[[[[[[[[[[[[[[[

부품

도구

  • ** 이메일**
  • 이메일 주소 수신
  • 입력:
  • recipient_id (string): 주소의 이메일 주소
  • subject (string): 이메일 제목
  • message (string): 이메일 내용
  • 반환 상태 및 message id

-trash-이메일

  • trash에 이메일 이동
  • 입력:
  • email_id (string): 이메일 자동 생성 ID
  • 성공 메시지 반환

-마크-이메일-as-read

  • 읽음으로 표시 이메일

  • 입력:

  • email_id (string): 이메일 자동 생성 ID

  • 성공 메시지 반환

  • ** get-unread-emails **

  • 읽지 않은 이메일

  • 이메일 ID를 포함한 이메일 목록

-읽기 이메일

  • 주어진 이메일 내용을 검색

  • 입력:

  • email_id (string): 이메일 자동 생성 ID

  • 이메일 메타데이터의 사전 및 읽음으로 이메일 표시

  • **open-email **

  • 브라우저에서 이메일 열기

  • 입력:

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Gmail Server for Model Context Protocol (MCP)

This MCP server integrates with Gmail to enable sending, removing, reading, drafting, and responding to emails.

Note: This server enables an MCP client to read, remove, and send emails. However, the client prompts the user before conducting such activities.

https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90

Components

Tools

  • send-email

    • Sends email to email address recipient
    • Input:
      • recipient_id (string): Email address of addressee
      • subject (string): Email subject
      • message (string): Email content
    • Returns status and message_id
  • trash-email

    • Moves email to trash
    • Input:
      • email_id (string): Auto-generated ID of email
    • Returns success message
  • mark-email-as-read

    • Marks email as read
    • Input:
      • email_id (string): Auto-generated ID of email
    • Returns success message
  • get-unread-emails

    • Retrieves unread emails
    • Returns list of emails including email ID
  • read-email

    • Retrieves given email content
    • Input:
      • email_id (string): Auto-generated ID of email
    • Returns dictionary of email metadata and marks email as read
  • open-email

    • Open email in browser
    • Input:
      • email_id (string): Auto-generated ID of email
    • Returns success message and opens given email in default browser

Setup

Gmail API Setup

  1. Create a new Google Cloud project
  2. Enable the Gmail API
  3. Configure an OAuth consent screen
    • Select “external”. However, we will not publish the app.
    • Add your personal email address as a “Test user”.
  4. Add OAuth scope https://www.googleapis.com/auth/gmail/modify
  5. Create an OAuth Client ID for application type “Desktop App”
  6. Download the JSON file of your client’s OAuth keys
  7. Rename the key file and save it to your local machine in a secure location. Take note of the location.
    • The absolute path to this file will be passed as parameter --creds-file-path when the server is started.

Authentication

When the server is started, an authentication flow will be launched in your system browser. Token credentials will be subsequently saved (and later retrieved) in the absolute file path passed to parameter --token-path.

For example, you may use a dot directory in your home folder, replacing [your-home-folder].:

Parameter Example
--creds-file-path /[your-home-folder]/.google/client_creds.json
--token-path /[your-home-folder]/.google/app_tokens.json

Usage with Desktop App

GitHub에서 전체 README 보기

설치

npx @modelcontextprotocol/inspector uv run [absolute-path-to-git-repo]/src/gmail/server.py --creds-file-path [absolute-path-to-credentials-file] --token-path [absolute-path-to-access-tokens-file]
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "gdrive": { "command": "uv", "args": [ "--directory", "[absolute-path-to-git-repo]", "run", "gmail", "--creds-file-path", "[absolute-path-to-credentials-file]", "--token-path", "[absolute-path-to-access-tokens-file]" ] } } }