readGoogleDocLABSCO SUMMARY
Formatting is what separates this from a text dump.
Reading and appending to a Doc is table stakes; applying a paragraph style, inserting a table at an index, or restyling every occurrence of a phrase is what makes a model useful on a document someone will actually read. The corresponding cost is the setup — a Google Cloud project, a consent screen, and a one-time manual authorization dance that ends in a token file with standing access to your Docs and Drive.
What it is
A comprehensive MCP server over the Google Docs and Google Drive APIs, built with fastmcp. It goes past reading and appending into real document structure — text styling, paragraph layout, tables and page breaks — and adds full Drive file management on top, with shared-drive support across every operation.
What you get
- Document access and editing:
readGoogleDocreturns plain text, JSON structure or markdown;appendToGoogleDocadds text;insertTextplaces it at a specific position;deleteRangeremoves content - Formatting that goes beyond plain text —
applyTextStylefor bold, italic and colours,applyParagraphStylefor alignment and spacing, andformatMatchingTextto format by content rather than by index - Structure:
insertTablecreates tables,insertPageBreakinserts breaks, andfixListFormattingis offered as an experimental automatic list detector - Drive discovery —
listGoogleDocs,searchGoogleDocs,getRecentGoogleDocsandgetDocumentInfofor detailed metadata - Folder and file management:
createFolder,listFolderContents,getFolderInfo,moveFile,copyFile,renameFile,deleteFile - Document creation from scratch with
createDocumentor from an existing template withcreateFromTemplate - Shared-drive support throughout, controlled by a
corporaparameter —userfor your personal drive,drivefor one shared drive with a drive ID, orallDrivesto search everything you can reach
Requirements
Your own Google Cloud project with both the Google Docs API and the Google Drive API enabled, an OAuth consent screen configured with the documents and drive.file scopes, and yourself added as a test user while the app is in testing mode. Create a Desktop app OAuth client, download the JSON and save it in the project root as credentials.json. Node.js 18 or higher and Git; then npm install and npm run build to compile to dist/. The first run is manual and interactive: start the compiled server, open the printed Google URL, approve, and paste the code back — the browser will land on a "site can't be reached" error, which is expected, and the code is the value between code= and &scope in the address bar. That writes token.json, which grants access from then on without asking again — protect it like a password, and keep both files out of version control. MIT licensed.
Setup effort
Build from source — git clone https://github.com/jasonWong-serviceDirect/google-docs-mcp-shared.git mcp-googledocs-server
USE CASES
Producing a formatted document, not a wall of text
Insert the content, then apply text and paragraph styles and drop in a table where one belongs.
Starting from an existing template
Create the new document from a template rather than pasting boilerplate, then fill in the sections.
Finding a document across a Workspace
Search with the corpora parameter set to all drives so shared-drive documents are included, not just your own.
Tidying a Drive folder
List the folder's contents, then move, copy or rename the files that are in the wrong place.
Restyling every mention of something
Format by matching text rather than by character index, so you do not have to compute positions.
23 tools
Listed in project docs. Your client may show a different list.
appendToGoogleDocinsertTextdeleteRangeapplyTextStyleapplyParagraphStyleformatMatchingTextinsertTableinsertPageBreakfixListFormattinglistGoogleDocssearchGoogleDocsgetRecentGoogleDocsgetDocumentInfocreateFolderlistFolderContentsgetFolderInfomoveFilecopyFilerenameFiledeleteFilecreateDocumentcreateFromTemplateBEFORE YOU INSTALL
What to know first
Tools you get
23 tools named in the project's documentation.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
In the Google Cloud Console (https://console.cloud.google.com/), enable the Google Docs API and Google Drive API, configure the OAuth consent screen with yourself as a Test User, create an OAuth client ID of type Desktop app, download its JSON and rename it to credentials.json
git clone https://github.com/jasonWong-serviceDirect/google-docs-mcp-shared.git mcp-googledocs-server
cd mcp-googledocs-serverMove credentials.json into the mcp-googledocs-server folder
npm install
npm run build
node ./dist/server.js # one-time Google sign-in: open the printed URL, allow access, paste the code from the localhost address back into the terminal — this writes token.jsonMCP Clients
Claude Desktop
{
"mcpServers": {
"google-docs-mcp": {
"command": "node",
"args": [
"<YOUR_PATH_TO_CLONED_REPO>/mcp-googledocs-server/dist/server.js"
],
"env": {}
}
}
}