The Google Slides connector lets your AI agent act in each user's Google Slides account. Each user signs in to Google Slides once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 5 tools.
- Tools
- 5
- What they doRead · write · destructive
- 3 · 2 · 03 read2 write0 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Google app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Google Slides connection
In AgentKit > Connections, create a Google Slides connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register a Google OAuth app
Google Slides connections use your own OAuth app. Register one with Google and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Google Slides connection.
Console steps with screenshots
Register your Scalekit environment with the Google Slides connector so Scalekit handles the authentication flow and token lifecycle for you. The connection name you create will be used to identify and invoke the connection programmatically. Then complete the configuration in your application as follows:
-
Set up auth redirects
-
In Scalekit dashboard, go to AgentKit > Connections > Create Connection. Find Google Slides and click Create. Click Use your own credentials and copy the redirect URI. It looks like
https://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback.
-
Navigate to Google Cloud Console → APIs & Services → Credentials. Select + Create Credentials, then OAuth client ID. Choose Web application from the Application type menu.

-
Under Authorized redirect URIs, click + Add URI, paste the redirect URI, and click Create.

-
-
Enable the Google Slides API
- In Google Cloud Console, go to APIs & Services → Library. Search for “Google Slides API” and click Enable.
-
Get client credentials
- Google provides your Client ID and Client Secret after you create the OAuth client ID in step 1.
-
Add credentials in Scalekit
-
In Scalekit dashboard, go to AgentKit > Connections and open the connection you created.
-
Enter your credentials:
- Client ID (from above)
- Client Secret (from above)
- Permissions (scopes — see Google API Scopes reference)

-
Click Save.
-
-
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'googleslides'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Google Slides:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'googleslides_read_presentation',toolInput: { presentation_id: 'YOUR_PRESENTATION_ID' },})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "googleslides"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Google Slides:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={"presentation_id":"YOUR_PRESENTATION_ID"},tool_name="googleslides_read_presentation",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolgoogleslides_get_pageGet the latest version of a single page (slide) within a Google Slides presentation, including its page elements, layout properties, and notes.Read-onlyGet Presentation Page
Get the latest version of a single page (slide) within a Google Slides presentation, including its page elements, layout properties, and notes.
Inputs
page_object_idstringrequired- The object ID of the page (slide) to retrieve
presentation_idstringrequired- The ID of the Google Slides presentation containing the page
fieldsstring- Fields to include in the response
googleslides_get_page_thumbnailGenerate and retrieve a thumbnail image URL for a single page (slide) in a Google Slides presentation.Read-onlyGet Page Thumbnail
Generate and retrieve a thumbnail image URL for a single page (slide) in a Google Slides presentation. The returned content URL is temporary, valid for about 30 minutes.
Inputs
page_object_idstringrequired- The object ID of the page (slide) to generate a thumbnail for
presentation_idstringrequired- The ID of the Google Slides presentation containing the page
mime_typestring- The image format of the thumbnailone of
PNG thumbnail_sizestring- The requested thumbnail image sizeone of
THUMBNAIL_SIZE_UNSPECIFIEDLARGEMEDIUMSMALL
googleslides_read_presentationRead the complete structure and content of a Google Slides presentation including slides, text, images, shapes, and metadata.Read-onlyRead Google Slides
Read the complete structure and content of a Google Slides presentation including slides, text, images, shapes, and metadata.
Inputs
presentation_idstringrequired- The ID of the Google Slides presentation to read
fieldsstring- Fields to include in the response
Also accepts
schema_versionandtool_versionto pin a version.googleslides_batch_update_presentationApply a batch of update requests to a Google Slides presentation in a single atomic call, such as inserting a slide, inserting text into a shape, creating a table, replacing text, or deleting an object.WriteBatch Update Presentation
Apply a batch of update requests to a Google Slides presentation in a single atomic call, such as inserting a slide, inserting text into a shape, creating a table, replacing text, or deleting an object. Returns the presentation ID and one reply per request, in the same order they were submitted.
Inputs
presentation_idstringrequired- The ID of the Google Slides presentation to update
requestsarrayrequired- Ordered list of update requests to apply. Each item is a Slides API Request object, e.g. {"createSlide": {...}} or {"insertText": {...}}
required_revision_idstring- If set, the update is rejected unless the presentation's current revision ID matches this value, protecting against concurrent edits
googleslides_create_presentationCreate a new Google Slides presentation with an optional title.WriteCreate Presentation
Create a new Google Slides presentation with an optional title.
Inputs
titlestring- Title of the new presentation
Also accepts
schema_versionandtool_versionto pin a version.
No tools match.
Workflows
Proxy API call
const result = await actions.request({ connectionName: 'googleslides', identifier: 'user_123', path: '/v1/presentations', method: 'GET',});console.log(result);result = actions.request( connection_name='googleslides', identifier='user_123', path="/v1/presentations", method="GET")print(result)Execute a tool
const result = await actions.executeTool({ connector: 'googleslides', identifier: 'user_123', toolName: 'googleslides_create_presentation', toolInput: {},});console.log(result);result = actions.execute_tool( connection_name='googleslides', identifier='user_123', tool_name='googleslides_create_presentation', tool_input={},)print(result)Google OAuth consent screen verification
Before you use your own Google OAuth credentials in production, understand what end users see on Google’s consent screen when they authorize a connected account.
| Audience type | Consent screen behavior | When to use |
|---|---|---|
| Internal | Shows your App Name and logo from Branding settings | Only users in your Google Workspace or Cloud Identity organization can authorize the connector |
| External | Shows {env_name}.scalekit.dev until Google verifies your app | Any user with a Google account can authorize the connector |
Why External is required for most AgentKit connectors:
- Internal restricts authorization to users in your Google Workspace or Cloud Identity organization. Users with
@gmail.comor other Google accounts outside your organization cannot complete OAuth. - External is required when end users outside your organization authorize tool access through connected accounts.
- Organization-managed OAuth clients follow the same rules as personal or developer OAuth clients. Switching to an org-owned client does not bypass Google verification.
- Until Google completes verification of your External app, users see
scalekit.devon the consent screen. After verification, your App Name and logo appear.
During development:
- Add Test users under APIs & Services → OAuth consent screen while publishing status is Testing.
- On unverified apps, users can click Advanced → Go to app (unsafe) to proceed during testing.
- Google Workspace admins may need to allowlist your OAuth client.
For Google’s verification requirements and timeline, refer to Google’s OAuth consent screen verification guide.