---
slug: "googleworkspace"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/mattcoatsworth/GoogleWorkSpace-MCP-Server@main/README.md"
repo: "https://github.com/mattcoatsworth/GoogleWorkSpace-MCP-Server"
source_file: "README.md"
branch: "main"
---
# Google Workspace MCP Server

    A Model Context Protocol (MCP) server for interacting with Google Workspace APIs including Gmail, Drive, Calendar, Docs, Sheets, and Slides.

    ## Features

    - **Gmail API**: Send emails, list messages, manage labels, and more
    - **Drive API**: List files, create folders, and upload files
    - **Docs API**: Create and edit Google Docs
    - **Sheets API**: Read and write spreadsheet data
    - **Slides API**: Create presentations and slides
    - **Calendar API**: List and create calendar events
    - **Authentication**: OAuth2 authentication flow helpers

    ## Prerequisites

    - Node.js 16+
    - Google Cloud project with the necessary APIs enabled
    - OAuth 2.0 client credentials

    ## Installation

    ```bash
    npm install
    ```

    ## Configuration

    1. Copy the `.env.example` file to `.env`:
       ```bash
       cp .env.example .env
       ```

    2. Edit the `.env` file with your Google API credentials:
       ```
       CLIENT_ID=your_client_id
       CLIENT_SECRET=your_client_secret
       REDIRECT_URI=http://localhost:3000/oauth2callback
       REFRESH_TOKEN=your_refresh_token
       ```

    3. If you don't have a refresh token yet, you can use the authentication tools provided by the server to get one.

    ## Usage

    ### Starting the Server

    ```bash
    npm run dev
    ```

    ### Using with MCP Inspector

    To test the server with the MCP Inspector:

    ```bash
    npm run inspect
    ```

    This will open the MCP Inspector in your browser, allowing you to test all tools and resources.

    ### Authentication

    If you don't have a refresh token, use these tools:

    1. Use the `generate_auth_url` tool to get an authorization URL
    2. Open the URL in a browser and authorize the application
    3. Copy the authorization code from the redirect URL
    4. Use the `exchange_code_for_tokens` tool with the code to get a refresh token
    5. Add the refresh token to your `.env` file

    ## Available Tools

    ### Gmail

    - `gmail_list_messages`: List Gmail messages with optional filters
    - `gmail_get_message`: Get a specific Gmail message by ID
    - `gmail_send_message`: Send a new email message
    - `gmail_list_labels`: List all Gmail labels
    - `gmail_modify_message`: Modify a message's labels
    - `gmail_trash_message`: Move a message to trash
    - `gmail_untrash_message`: Remove a message from trash
    - `gmail_create_draft`: Create a draft email

    ### Drive

    - `drive_list_files`: List files in Google Drive
    - `drive_get_file`: Get metadata for a specific file
    - `drive_create_folder`: Create a new folder in Google Drive
    - `drive_upload_file`: Upload a file to Google Drive

    ### Docs

    - `docs_get_document`: Get the content of a Google Doc
    - `docs_create_document`: Create a new Google Doc
    - `docs_append_text`: Append text to a Google Doc

    ### Sheets

    - `sheets_get_values`: Get values from a Google Sheet
    - `sheets_update_values`: Update values in a Google Sheet
    - `sheets_create_spreadsheet`: Create a new Google Sheet

    ### Slides

    - `slides_create_presentation`: Create a new Google Slides presentation
    - `slides_get_presentation`: Get information about a Google Slides presentation
    - `slides_create_slide`: Create a new slide in a presentation

    ### Calendar

    - `calendar_list_events`: List events from Google Calendar
    - `calendar_create_event`: Create a new event in Google Calendar

    ### Authentication

    - `generate_auth_url`: Generate an OAuth2 authorization URL
    - `exchange_code_for_tokens`: Exchange an authorization code for OAuth2 tokens

    ## Available Resources

    - `gmail://message/{messageId}`: Get a specific Gmail message
    - `gmail://thread/{threadId}`: Get a Gmail thread with all messages
    - `gmail://labels`: List all Gmail labels
    - `workspace://docs/{service}`: Documentation for a specific Google Workspace API
    - `workspace://auth/guide`: Authentication guide for Google Workspace APIs

    ## License

    MIT