Google Workspace MCP Server

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