MCP Server for Google Services

You set up a dedicated MCP (Model Context Protocol) server that integrates Google services with Claude Desktop. It exposes 80+ tools to manage Gmail, Calendar, Drive, Sheets, Docs, and more, enabling you to automate and streamline everyday workflows from Claude’s interface.

How to use

Launch Claude Desktop and ensure your Google-enabled MCP server is running. You will access a suite of tools organized by Google service, such as email, calendar, drive, sheets, and docs. Use natural language prompts or explicit tool names to perform tasks like searching emails, creating calendar events, reading documents, or updating spreadsheets.

How to install

Prerequisites you need before starting:

• Python 3.8+
• Claude Desktop
• A Google Cloud Project with APIs enabled (Gmail, Calendar, Drive, Sheets)

Step-by-step commands and actions you should run or perform in order:

# Step 1: Clone the project repository
# (Replace with the exact path if you have a different location)
git clone https://github.com/pbulbule13/mcpwithgoogle.git
cd mcpwithgoogle

# Step 2: Install dependencies
pip install -r requirements.txt

# Step 3: Google Cloud setup and credentials (assumes you already created credentials.json)
# Place credentials.json in the project root

# Step 4: Authenticate with Google
python authenticate.py

# Step 5: Configure Claude Desktop to point to the MCP server (see below)

Additional configuration and run details

The server is designed to be run locally and accessed through Claude Desktop. You will typically set up a stdio (local) MCP server entry so Claude can start the Python-based MCP server directly from your machine.

MCP server configuration (stdio)

{
  "google-workspace": {
    "command": "python",
    "args": [
      "C:\\path\\to\\mcpwithgoogle\\src\\mcp_server.py"
    ],
    "env": {},
    "cwd": "C:\\path\\to\\mcpwithgoogle"
  }
}

Authenticate with Google

Run the authentication script to authorize access to Google services. This will open a browser window for you to grant permissions. Upon successful authorization, tokens will be saved locally for future use.

pip install -r requirements.txt
python authenticate.py

Claude Desktop integration

Edit your Claude Desktop configuration to include the MCP server. Use an absolute path to the Python command and the server script, and specify the working directory so Claude can launch the server reliably.

{
  "mcpServers": {
    "google-workspace": {
      "command": "python",
      "args": [
        "C:\\path\\to\\mcpwithgoogle\\src\\mcp_server.py"
      ],
      "env": {},
      "cwd": "C:\\path\\to\\mcpwithgoogle"
    }
  }
}

Restart Claude Desktop and verify

Fully quit Claude Desktop and relaunch it. After startup, the tools provided by the Google MCP server should appear automatically in the tool list.

Troubleshooting

If the MCP server does not appear or tools don’t respond, verify the following:

• The path to the MCP server script is correct in the Claude Desktop config.
• Python is installed and available in your system PATH.
• The Google credentials file is present at the project root and the OAuth flow completed successfully.
• Claude Desktop was fully restarted after adding the MCP server configuration.

Security and maintenance

Keep credentials and tokens secure. Do not commit credentials.json or tokens.json to version control. Regularly review OAuth scopes and rotate credentials if needed.

Notes on tools and usage

This MCP server exposes a comprehensive set of tools for Gmail, Calendar, Drive, Sheets, Docs, and an in-memory persistence layer for context and preferences. You can remember and recall information to tailor responses, or forget or list stored memories as needed.

Available tools

search_emails

Search Gmail with queries to locate messages matching specific criteria.

get_email

Retrieve a Gmail message by its ID.

send_email

Compose and send a new Gmail message.

reply_to_email

Reply to an existing Gmail message.

list_labels

List labels in Gmail to organize messages.

create_label

Create a new Gmail label.

move_to_label

Move an email to a specified label.

get_calendar_events

List Google Calendar events.

create_calendar_event

Create a new calendar event.

update_calendar_event

Update an existing calendar event.

delete_calendar_event

Delete a calendar event.

find_free_slots

Find available time slots in the calendar.

search_drive

Search files in Google Drive.

list_drive_files

List files in a Google Drive folder.

get_file_content

Read the content of a Drive file.

create_folder

Create a new folder in Drive.

read_sheet

Read data from a Google Sheet.

write_sheet

Write data to a Google Sheet.

append_sheet

Append rows to a Google Sheet.

create_sheet

Create a new Google Sheet.

create_doc

Create a new Google Docs document.

read_doc

Read content from a Google Docs document.

remember

Store contextual information for later recall.

recall

Retrieve stored memories or context.

forget

Remove specific stored memories.

list_memories

List all stored memories and contexts.