Google Docs MCP Server

🚀 Google Docs MCP Server

The Google Docs MCP Server is an intermediate platform for interacting with the Google Docs API. It enables you to create, read, update, and delete Google Docs via commands, and also supports functions such as export, sharing, and search.

🚀 Quick Start

The Google Docs MCP Server serves as an intermediary platform for seamless interaction with the Google Docs API. It empowers users to perform a range of operations on Google Docs using commands, including creation, retrieval, modification, and deletion. Additionally, it offers functionalities like document export, sharing, and search.

✨ Features

• Interact with Google Docs API through commands.
• Support basic CRUD operations (Create, Read, Update, Delete) on Google Docs.
• Provide document export, sharing, and search functions.

📦 Installation

Install Dependencies

Use the following command to install the required dependencies:

npm install

Run the Server

Run the server:

node dist/index.js

🔧 Authentication Configuration

To interact with the Google Docs API, you need appropriate authentication information. Here are several supported authentication methods:

1. Use Google Cloud Project ID and Service Account Key JSON

• Parameters:
  • GOOGLE_CLOUD_PROJECT_ID: Your Google Cloud project ID.
  • GOOGLE_APPLICATION_CREDENTIALS: The path to the JSON file containing your service account key.

    export GOOGLE_CLOUD_PROJECT_ID=your-project-id
    export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
    

2. Use API Key

• Parameters:
  • GOOGLE_API_KEY: Your Google API key.

    export GOOGLE_API_KEY=your-api-key
    

3. Use OAuth 2.0 (for user authentication)

• Parameters:
  • client_id: Your application client ID.
  • client_secret: Your application client secret.
  • refresh_token: The user's refresh token.

    export client_id=your-client-id
    export client_secret=your-client-secret
    export refresh_token=your-refresh-token
    

🐳 Docker Support

Build the Image

docker build -t google-docs-mcp-server .

Run the Container

docker run -p 8080:8080 \
  -e GOOGLE_CLOUD_PROJECT_ID=your-project-id \
  -e GOOGLE_APPLICATION_CREDENTIALS_JSON='{"type":"service_account","project_id":"..."}' \
  -e client_id=your-client-id \
  -e client_secret=your-client-secret \
  -e refresh_token=your-refresh-token \
  -e AUTH_SERVER_URL=https://your-auth-server.com/verify \
  google-docs-mcp-server

🛠️ MCP Integration

To use this server in Claude or other MCP-supported assistants, add it to the MCP settings:

{
  "mcpServers": {
    "google-docs": {
      "command": "node",
      "args": ["/path/to/google-docs-mcp-server/dist/index.js"],
      "config": {
        "GOOGLE_CLOUD_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account-key.json"
      }
    }
  }
}

🛠️ Available Tools

The following operations can be performed through the server:

💻 Usage Examples

Create a New Document

{
  "command": "createDocument",
  "params": {
    "documentTitle": "My New Document",
    "body": "This is the content of the new document."
  }
}

Update an Existing Document

{
  "command": "updateDocument",
  "params": {
    "id": "1234567890abcdefghijklmnopqrstuvwxyz",
    "newBody": "Updated content of the document."
  }
}

📄 License

This project is licensed under the MIT License. For details, please refer to the LICENSE file.