jikime/py-mcp-google-toolbox

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

10 stars 8 forks 품질 57 트렌드 8

An MCP server that provides AI assistants with powerful tools to interact with Google services, including Gmail, Google Calendar, Google Drive, and Google Search.

개요

An MCP server that provides AI assistants with powerful tools to interact with Google services, including Gmail, Google Calendar, Google Drive, and Google Search. py-mcp-google-toolbox provides the following Google-related functionalities: - Gmail operations (read, search, send, modify) - Google Calendar management (events creation, listing, updating, deletion) - Google Drive interactions (search, read files) - Google Search integration (search web) 1. : Install Python 3.12 or higher 2. : - Go to Google Cloud Console - Create a new project or select an existing one - Enable the Service API: 1. Go to "APIs & Services" > "Library" 2. Search for and enable "Gmail API" 3. Search for and enable "Google Calendar API" 4. Search for and enable "Google Drive API" 5. Search formand enable "Custom Search API" - Set up OAuth 2.0 credentials from GCP: 1. Go to "APIs & Services" > "Credentials" 2. Click "Create Credentials" > "OAuth client ID" 3. Choose "Web application" 4.

README

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

py-mcp-google-toolbox

An MCP server that provides AI assistants with powerful tools to interact with Google services, including Gmail, Google Calendar, Google Drive, and Google Search.

Overview

py-mcp-google-toolbox provides the following Google-related functionalities:

Gmail operations (read, search, send, modify)
Google Calendar management (events creation, listing, updating, deletion)
Google Drive interactions (search, read files)
Google Search integration (search web)

Prerequisites
Installation
Configure MCP Settings
Tools Documentation
Development
License

Prerequisites

Python: Install Python 3.12 or higher
Google Cloud Console Setup:
- Go to Google Cloud Console
- Create a new project or select an existing one
- Enable the Service API:
  1. Go to “APIs & Services” > “Library”
  2. Search for and enable “Gmail API”
  3. Search for and enable “Google Calendar API”
  4. Search for and enable “Google Drive API”
  5. Search formand enable “Custom Search API”
- Set up OAuth 2.0 credentials from GCP:
  1. Go to “APIs & Services” > “Credentials”
  2. Click “Create Credentials” > “OAuth client ID”
  3. Choose “Web application”
  4. Note down the Client ID and Client Secret
    - Client ID
    - Client Secret
  5. download secret json and rename to credentials.json
- Generate an API key
Go to Custom Search Engine and get its ID

Installation

Git Clone

git clone https://github.com/jikime/py-mcp-google-toolbox.git
cd py-mcp-google-toolbox

Configuration

Install UV package manager:

curl -LsSf https://astral.sh/uv/install.sh | sh

Create and activate virtual environment:

uv venv -p 3.12
source .venv/bin/activate  # On MacOS/Linux
# or
.venv\Scripts\activate  # On Windows

Install dependencies:

uv pip install -r requirements.txt

Get refresh token (if token is expired, you can run this)

uv run get_refresh_token.py

This will:

Open your browser for Google OAuth authentication
Request the following permissions:

GitHub에서 전체 README 보기

설치

docker run -i --rm py-mcp-google-toolbox

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "Google Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-google-toolbox",
        "run",
        "server.py"
      ]
    }
  }
}