Google Docs

Connect to Google Docs. Create, edit, and collaborate on documents

Supports authentication: OAuth 2.0

Usage

Connect a user’s Google Docs account and make API calls on their behalf — Scalekit handles OAuth and token management automatically.

You can interact with Google Docs in two ways — via direct proxy API calls or via Scalekit optimized tool calls. Scroll down to see the list of available Scalekit tools.

1
import { ScalekitClient } from '@scalekit-sdk/node';
2
import 'dotenv/config';
3

4
const connectionName = 'google_docs'; // get your connection name from connection configurations
5
const identifier = 'user_123';        // your unique user identifier
6

7
// Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
8
const scalekit = new ScalekitClient(
9
  process.env.SCALEKIT_ENV_URL,
10
  process.env.SCALEKIT_CLIENT_ID,
11
  process.env.SCALEKIT_CLIENT_SECRET
12
);
13
const actions = scalekit.actions;
14

15
// Authenticate the user
16
const { link } = await actions.getAuthorizationLink({
17
  connectionName,
18
  identifier,
19
});
20
console.log('🔗 Authorize Google Docs:', link); // present this link to your user for authorization, or click it yourself for testing
21
process.stdout.write('Press Enter after authorizing...');
22
await new Promise(r => process.stdin.once('data', r));
23

24
// Make a request via Scalekit proxy
25
const result = await actions.request({
26
  connectionName,
27
  identifier,
28
  path: '/v1/documents',
29
  method: 'GET',
30
});
31
console.log(result);

1
import scalekit.client, os
2
from dotenv import load_dotenv
3
load_dotenv()
4

5
connection_name = "google_docs"  # get your connection name from connection configurations
6
identifier = "user_123"          # your unique user identifier
7

8
# Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
9
scalekit_client = scalekit.client.ScalekitClient(
10
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
11
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
12
    env_url=os.getenv("SCALEKIT_ENV_URL"),
13
)
14
actions = scalekit_client.actions
15

16
# Authenticate the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier
20
)
21
# present this link to your user for authorization, or click it yourself for testing
22
print("🔗 Authorize Google Docs:", link_response.link)
23
input("Press Enter after authorizing...")
24

25
# Make a request via Scalekit proxy
26
result = actions.request(
27
    connection_name=connection_name,
28
    identifier=identifier,
29
    path="/v1/documents",
30
    method="GET"
31
)
32
print(result)

Scalekit Tools

`googledocs_create_document`

Create a new blank Google Doc with an optional title. Returns the new document’s ID and metadata.

Name	Type	Required	Description
`schema_version`	string	No	Optional schema version to use for tool execution
`title`	string	No	Title of the new document
`tool_version`	string	No	Optional tool version to use for execution

`googledocs_read_document`

Read the complete content and structure of a Google Doc including text, formatting, tables, and metadata.

Name	Type	Required	Description
`document_id`	string	Yes	The ID of the Google Doc to read
`schema_version`	string	No	Optional schema version to use for tool execution
`suggestions_view_mode`	string	No	How suggestions are rendered in the response
`tool_version`	string	No	Optional tool version to use for execution

`googledocs_update_document`

Update the content of an existing Google Doc using batch update requests. Supports inserting and deleting text, formatting, tables, and other document elements.

Name	Type	Required	Description
`document_id`	string	Yes	The ID of the Google Doc to update
`requests`	`array<object>`	Yes	Array of update requests to apply to the document
`schema_version`	string	No	Optional schema version to use for tool execution
`tool_version`	string	No	Optional tool version to use for execution
`write_control`	`object`	No	Optional write control for revision management

Tool list