Google Drive MCP Server

What is Google Drive MCP Server?

Google Drive MCP Server is a Model Context Protocol (MCP) server built with FastMCP that provides tools for reading, writing, searching, and listing files in Google Drive, with a focus on Google Docs operations. It is designed for developers and AI agents who need to programmatically interact with Google Drive using service account authentication.

How to use Google Drive MCP Server?

After installing dependencies with uv sync, enable the Google Drive and Google Docs APIs, create a service account, and save its key file as service-account-key.json in the project root. Share target Drive files/folders with the service account email. Run python -m google_drive_mcp.server – no interactive authentication flow is required.

Key features of Google Drive MCP Server

• List files with optional folder, MIME type, and pagination.
• Search files using Google Drive query syntax.
• Read Google Docs content with pagination and tab selection.
• Write or replace content in Google Docs with tab and range controls.
• Service account authentication for server‑to‑server access.

Use cases of Google Drive MCP Server

• Search for Google Docs containing specific keywords.
• Read large documents in paginated chunks.
• Write data to a specific tab or insertion point in a document.
• List and filter files in a shared folder.
• Replace existing content in a document using start/end indices.

FAQ from Google Drive MCP Server

What tools does Google Drive MCP Server provide?

It provides four tools: list_files, search_files, read_document, and write_document.

How do I authenticate?

Authentication uses a service account key file placed as service-account-key.json in the project root. No OAuth user flow is needed.

What are the runtime dependencies?

Python, uv for dependency management, and the FastMCP library with Google API client libraries (installed via uv sync).

How does pagination work for files and documents?

File listing accepts page_token and page_size (max 100). Document reading accepts start_index and length (max 10,000 characters) to navigate parts of a document.

Can I access files not shared with the service account?

No. Any file or folder you want to access must be explicitly shared with the service account’s email address.