What is Mcp Googledocs

mcp-googledocs is a project that integrates with Google Docs and Drive using the Google API Client Library for Python, providing tools for programmatic management of Google Docs documents.

Use cases

Use cases include automating the creation of reports, updating documents based on user input, and integrating Google Docs functionalities into web applications.

How to use

To use mcp-googledocs, set up a Google Cloud project, obtain OAuth 2.0 credentials, install the necessary dependencies, and run the server using ‘python google_docs.py’.

Key features

Key features include document management tools such as retrieving a document by ID, creating new documents with specified titles and content, and updating document content with styles.

Where to use

mcp-googledocs can be used in various fields including software development, automation of document management, and integration of Google Docs into applications.

Project Overview

This project integrates with Google Docs and Drive using the Google API Client Library for Python. It provides tools to manage Google Docs documents programmatically.

Features

Document Management Tools

• get_document: Retrieve a Google Doc by its ID
• create_document: Create a new Google Doc with a specified title and content
• update_document_content: Update a Google Doc with styled content

Prerequisites

• Python 3.7 or higher
• Google Cloud project with API access enabled
• OAuth 2.0 credentials

Setup

1. Create a Google Cloud Project

   • Go to Google Cloud Console
   • Create a new project or select an existing one
   • Enable Google Docs and Drive APIs

2. Get OAuth 2.0 Credentials

   • In Google Cloud Console, go to APIs & Services > Credentials
   • Click “Create Credentials” and select “OAuth client ID”
   • Save the JSON file as credentials.json in your project root

3. Install Dependencies

   uv add google-api-python-client
   uv add "mcp[cli]"
   

Dependencies

• google-api-python-client: For interacting with Google APIs.
• mcp: For managing the Model Context Protocol.

Usage

To use the tools provided by this project, you need to authenticate with Google APIs. Follow the instructions in the code to set up your credentials.

Running the Server

To run the MCP server for Google Docs, execute the following command:

python google_docs.py

This will start the server and you should see a message indicating that the Google Docs MCP server is running.

Debugging

1. Server Logs

   Enable debug logs by setting the environment variable:

   export LOG_LEVEL=debug
   

2. Tool Testing

   Test individual tools using the MCP CLI:

   mcp test google_docs.py --tool get_document
   

Usage Examples

Document Operations

# Create a new document
await create_document(title="My Document", content="Hello, world!")

# Update document content
await update_document_content(document_id="doc123", content="Updated content")

Response Format

All tools return responses in a consistent format:

# Success response
{
    "success": True,
    "data": {...},  # or relevant success data
    "message": "Operation completed successfully"
}

# Error response
{
    "success": False,
    "error": "Error message details"
}

Security Considerations

1. OAuth Credentials

   • Never commit your credentials.json to version control
   • Add it to .gitignore
   • Use environment variables in production

Contributing

Contributions are welcome! Please follow the standard guidelines for contributing to open-source projects.

Creating a uv-Managed Project

If you haven’t created a uv-managed project yet, you can do so with the following commands:

uv init my-project
cd my-project

Adding MCP to Dependencies

To add MCP to your project dependencies, use the following command:

uv add "mcp[cli]"

This command is for adding MCP to uv-managed Python projects. If you’re not familiar with uv, please refer to the uv documentation.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For issues and feature requests, please create an issue in the GitHub repository.