Google Docs MCP Server

A Model Context Protocol (MCP) server for Google Docs API, allowing language models to create, search, append to, and update Google Docs.

Features

- Search Docs: Search for Google Docs in Drive with custom queries
- Create Doc: Create new Google Docs with optional initial content
- Append to Doc: Append content to the end of an existing Google Doc
- Update Doc: Replace content in an existing Google Doc with new content

Setup

Prerequisites

- Node.js (v14 or higher)
- npm
- Google Cloud Platform account with the Google Drive and Google Docs APIs enabled

Installation

1. Clone this repository:

   git clone <repository-url>

   cd google-docs-mcp-server

   

2. Install dependencies:

   npm install

   

3. Set up Google API credentials:
- Go to the Google Cloud Console
- Create a new project (or select an existing one)
- Enable the Google Drive API and Google Docs API
- Create OAuth 2.0 credentials (Desktop application)
- Download the credentials JSON file and save it as credentials.json in the project root

4. Get authentication tokens:

   node get-refresh-token.js

   

5. Build the server:

   npm run build

   

Building the Extism Plugin

The server uses an Extism WebAssembly plugin to interact with the Google Docs API. To build the plugin:

cd extism-plugin
npm install
npm run build

This will create the plugin.wasm file in the dist directory.

Usage

Running the Server

Start the MCP server:

npm start

Or with explicit node command:

node build/index.js

Testing the Plugin Directly

You can test the Extism plugin directly using the Extism CLI:

cd extism-plugin
extism call --wasi --allow-host www.googleapis.com --allow-host docs.googleapis.com --config GOOGLE_ACCESS_TOKEN=<your-access-token> dist/plugin.wasm describe

To search for docs:

extism call --wasi --allow-host www.googleapis.com --allow-host docs.googleapis.com --config GOOGLE_ACCESS_TOKEN=<your-access-token> dist/plugin.wasm call --input '{"toolId": "search_docs", "arguments": {"query": "name contains \"report\""}}'

To create a new doc:

extism call --wasi --allow-host www.googleapis.com --allow-host docs.googleapis.com --config GOOGLE_ACCESS_TOKEN=<your-access-token> dist/plugin.wasm call --input '{"toolId": "create_doc", "arguments": {"title": "My New Document", "content": "Initial content"}}'

License

MIT