Skip to main content

Google Docs MCP

In one line: Connect Google Docs so your UnleashX agent can create documents, read them, and append or replace text for you.
CategoryProductivity
AuthenticationOAuth (Google sign-in)
Setup time~2 minutes
DifficultyEasy
Best forGenerating and updating documents from AI output and building repeatable doc workflows

1. Overview

Google Docs is Google’s word-processing service for creating and editing text documents stored in Drive. Once connected, your UnleashX agent can list drives, folders, and documents, create new documents in a folder, read a document’s content, replace matching text, append text, generate an AI image into a doc, and watch for newly created documents. Connecting Google Docs to UnleashX makes document work conversational: ask “draft a project brief in the Projects folder” or “append today’s summary to the standup doc,” and the agent creates or updates the right document automatically.

2. What you’ll need

1

A Google account with Docs

Any personal Google account or a Google Workspace account with Docs enabled.
2

Permission to grant access

You must be able to complete the Google sign-in and approve the requested permissions.
3

An UnleashX agent

An agent in your UnleashX workspace where you’ll add the Docs connector.
No admin access? On a managed Google Workspace account, your admin may need to allow UnleashX before authorization succeeds.

3. Get your credentials

Google Docs uses Google OAuth 2.0. You do not create or paste an API key. UnleashX redirects you to Google, you sign in once, and Google issues an access token to UnleashX automatically.
1

Start the connection in UnleashX

In your agent’s Data Connectors, find Google Docs and click Connect (see Section 4).
2

Sign in with Google

Choose the Google account whose documents you want to connect.
3

Review and approve the requested scopes

Click Allow to grant access and return to UnleashX.
There is no key to copy. Access is granted by your Google sign-in and can be revoked anytime at your Google Account permissions page.
Scopes UnleashX requests for Google Docs:
ScopeWhy UnleashX needs it
https://www.googleapis.com/auth/documentsRead and edit document content (replace/append text).
https://www.googleapis.com/auth/driveList drives/folders/documents and create or delete document files.
https://www.googleapis.com/auth/userinfo.emailIdentify which account is connected.

4. Connect on UnleashX

1

Open your agent

Sign in at https://www.tryunleashx.com and open your agent.
2

Go to Data Connectors

In the agent, open Data Connectors.
3

Find Google Docs and connect

Locate Google Docs and click Connect / Add / Configure.
4

Authorize with Google

Click Authorize, sign in with Google, and approve the requested permissions.
5

Confirm success

You’ll return to UnleashX and the connector status will show a Connected badge.
01 docs connector

5. Available tools

ToolWhat it doesChanges data?
List DrivesList available Google Drives.No
Folder ListList folders in a specific drive.No
List DocumentList documents in a specific folder.No
Create DocumentCreate a new Google Document in a folder.✏️ Yes
Delete DocumentDelete a Google Document.⚠️ Yes
Get Content DocumentRead a document’s content.No
Replace TextReplace all occurrences of text in a document.✏️ Yes
Append TextAppend text to the end of a document.✏️ Yes
On New Document CreatedTrigger: return documents added since last run.No
Generate AI ImageGenerate an AI image (for use in a document).✏️ Yes

6. Example usage

“Create a doc called ‘Kickoff Notes’ in the Projects folder and add today’s agenda.” Runs Create Document, then Append Text.
“In the contract doc, replace ‘Acme Inc.’ with ‘Acme Corporation’.” Runs Replace Text on the target document.

7. Permissions & data access

UnleashX can:
  • List drives, folders, and documents.
  • Create and delete documents.
  • Read document content, replace text, and append text.
  • Generate AI images for documents.
UnleashX cannot:
  • Access Gmail, Calendar, or other Google services unless connected separately.
  • Change your Google account settings or password.
  • Edit documents you don’t have access to.
To disconnect: In UnleashX, open Data Connectors → Google Docs → Disconnect, or revoke at https://myaccount.google.com/permissions. Revoking takes effect immediately. The connection authenticates each request with your Google OAuth access token (resolved from an access-token header, a google_docs_access_token header, or an Authorization: Bearer header, falling back to your UnleashX session), refreshed automatically when it expires.

8. Troubleshooting

ProblemWhat it meansHow to fix it
401 UnauthorizedThe access token is missing or expired.Reconnect Google Docs in Data Connectors.
403 ForbiddenMissing scope, or you lack edit rights on the document.Re-authorize all scopes; confirm you can edit the file.
404 Not FoundThe document or folder ID is wrong or not shared with you.Verify the document_id/folder_id and your access.
Replace did nothingThe search text didn’t match (case sensitivity).Check exact text and the match_case setting.
For general connector issues, see /mcp/integrations.

9. Frequently asked questions

Does UnleashX store my documents? No. It reads and writes through Google’s API in real time to fulfill your requests. Can multiple team members connect Docs? Yes. Each person authorizes their own Google account. Can it format text, not just insert it? The tools focus on creating documents and inserting/replacing text. Rich formatting beyond that isn’t exposed by these tools.

10. References