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

    npm install
    

## Configuration

1. Copy the .env.example file to .env:

       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

    npm run dev
    

### Using with MCP Inspector

To test the server with the MCP Inspector:

    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