Skip to main content

​
Overview

Enable your agents to create, edit, and manage Google Docs documents with text manipulation and formatting. Automate document creation, insert and replace text, manage content ranges, and streamline your document workflows with AI-powered automation.

​
Prerequisites

Before using the Google Docs integration, ensure you have:
  • A CrewAI AMP account with an active subscription
  • A Google account with Google Docs access
  • Connected your Google account through the Integrations page

​
Setting Up Google Docs Integration

​
1. Connect Your Google Account

  1. Navigate to CrewAI AMP Integrations
  2. Find Google Docs in the Authentication Integrations section
  3. Click Connect and complete the OAuth flow
  4. Grant the necessary permissions for document access
  5. Copy your Enterprise Token from Integration Settings

​
2. Install Required Package

uv add crewai-tools

​
Available Actions

Description: Create a new Google Document.Parameters:
  • title (string, optional): The title for the new document.
Description: Get the contents and metadata of a Google Document.Parameters:
  • documentId (string, required): The ID of the document to retrieve.
  • includeTabsContent (boolean, optional): Whether to include tab content. Default is false.
  • suggestionsViewMode (string, optional): The suggestions view mode to apply to the document. Enum: DEFAULT_FOR_CURRENT_ACCESS, PREVIEW_SUGGESTIONS_ACCEPTED, PREVIEW_WITHOUT_SUGGESTIONS. Default is DEFAULT_FOR_CURRENT_ACCESS.
Description: Apply one or more updates to a Google Document.Parameters:
  • documentId (string, required): The ID of the document to update.
  • requests (array, required): A list of updates to apply to the document. Each item is an object representing a request.
  • writeControl (object, optional): Provides control over how write requests are executed. Contains requiredRevisionId (string) and targetRevisionId (string).
Description: Insert text into a Google Document at a specific location.Parameters:
  • documentId (string, required): The ID of the document to update.
  • text (string, required): The text to insert.
  • index (integer, optional): The zero-based index where to insert the text. Default is 1.
Description: Replace all instances of text in a Google Document.Parameters:
  • documentId (string, required): The ID of the document to update.
  • containsText (string, required): The text to find and replace.
  • replaceText (string, required): The text to replace it with.
  • matchCase (boolean, optional): Whether the search should respect case. Default is false.
Description: Delete content from a specific range in a Google Document.Parameters:
  • documentId (string, required): The ID of the document to update.
  • startIndex (integer, required): The start index of the range to delete.
  • endIndex (integer, required): The end index of the range to delete.
Description: Insert a page break at a specific location in a Google Document.Parameters:
  • documentId (string, required): The ID of the document to update.
  • index (integer, optional): The zero-based index where to insert the page break. Default is 1.
Description: Create a named range in a Google Document.Parameters:
  • documentId (string, required): The ID of the document to update.
  • name (string, required): The name for the named range.
  • startIndex (integer, required): The start index of the range.
  • endIndex (integer, required): The end index of the range.

​
Usage Examples

​
Basic Google Docs Agent Setup

from crewai import Agent, Task, Crew

# Create an agent with Google Docs capabilities
docs_agent = Agent(
    role="Document Creator",
    goal="Create and manage Google Docs documents efficiently",
    backstory="An AI assistant specialized in Google Docs document creation and editing.",
    apps=['google_docs']  # All Google Docs actions will be available
)

# Task to create a new document
create_doc_task = Task(
    description="Create a new Google Document titled 'Project Status Report'",
    agent=docs_agent,
    expected_output="New Google Document 'Project Status Report' created successfully"
)

# Run the task
crew = Crew(
    agents=[docs_agent],
    tasks=[create_doc_task]
)

crew.kickoff()

​
Text Editing and Content Management

from crewai import Agent, Task, Crew

# Create an agent focused on text editing
text_editor = Agent(
    role="Document Editor",
    goal="Edit and update content in Google Docs documents",
    backstory="An AI assistant skilled in precise text editing and content management.",
    apps=['google_docs/insert_text', 'google_docs/replace_text', 'google_docs/delete_content_range']
)

# Task to edit document content
edit_content_task = Task(
    description="In document 'your_document_id', insert the text 'Executive Summary: ' at the beginning, then replace all instances of 'TODO' with 'COMPLETED'.",
    agent=text_editor,
    expected_output="Document updated with new text inserted and TODO items replaced."
)

crew = Crew(
    agents=[text_editor],
    tasks=[edit_content_task]
)

crew.kickoff()

​
Advanced Document Operations

from crewai import Agent, Task, Crew

# Create an agent for advanced document operations
document_formatter = Agent(
    role="Document Formatter",
    goal="Apply advanced formatting and structure to Google Docs",
    backstory="An AI assistant that handles complex document formatting and organization.",
    apps=['google_docs/batch_update', 'google_docs/insert_page_break', 'google_docs/create_named_range']
)

# Task to format document
format_doc_task = Task(
    description="In document 'your_document_id', insert a page break at position 100, create a named range called 'Introduction' for characters 1-50, and apply batch formatting updates.",
    agent=document_formatter,
    expected_output="Document formatted with page break, named range, and styling applied."
)

crew = Crew(
    agents=[document_formatter],
    tasks=[format_doc_task]
)

crew.kickoff()

​
Troubleshooting

​
Common Issues

Authentication Errors
  • Ensure your Google account has the necessary permissions for Google Docs access.
  • Verify that the OAuth connection includes all required scopes (https://www.googleapis.com/auth/documents).
Document ID Issues
  • Double-check document IDs for correctness.
  • Ensure the document exists and is accessible to your account.
  • Document IDs can be found in the Google Docs URL.
Text Insertion and Range Operations
  • When using insert_text or delete_content_range, ensure index positions are valid.
  • Remember that Google Docs uses zero-based indexing.
  • The document must have content at the specified index positions.
Batch Update Request Formatting
  • When using batch_update, ensure the requests array is correctly formatted according to the Google Docs API documentation.
  • Complex updates require specific JSON structures for each request type.
Replace Text Operations
  • For replace_text, ensure the containsText parameter exactly matches the text you want to replace.
  • Use matchCase parameter to control case sensitivity.

​
Getting Help

Need Help?

Contact our support team for assistance with Google Docs integration setup or troubleshooting.
⌘I