Googleslides

Learn how to use Googleslides with Composio

Overview

SLUG: GOOGLESLIDES

Description

Google Slides is a cloud-based presentation editor with real-time collaboration, template gallery, and integration with other Google Workspace apps

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to https://www.googleapis.com/auth/presentations,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/drive
bearer_token
string
token
stringRequired

Connecting to Googleslides

Create an auth config

Use the dashboard to create an auth config for the Googleslides toolkit. This allows you to connect multiple Googleslides accounts to Composio for agents to use.

1

Select App

Navigate to Googleslides.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Googleslides Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1from composio import Composio
2
3# Replace these with your actual values
4googleslides_auth_config_id = "ac_YOUR_GOOGLESLIDES_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/application
6
7composio = Composio()
8
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11 connection_request = composio.connected_accounts.initiate(
12 user_id=user_id,
13 auth_config_id=auth_config_id,
14 )
15
16 print(
17 f"Visit this URL to authenticate Googleslides: {connection_request.redirect_url}"
18 )
19
20 # This will wait for the auth flow to be completed
21 connection_request.wait_for_connection(timeout=15)
22 return connection_request.id
23
24
25connection_id = authenticate_toolkit(user_id, googleslides_auth_config_id)
26
27# You can also verify the connection status using:
28connected_account = composio.connected_accounts.get(connection_id)
29print(f"Connected account: {connected_account}")

Using Bearer Token

1from composio import Composio
2
3# Auth config ID created above
4googleslides_auth_config_id = "ac_YOUR_GOOGLESLIDES_CONFIG_ID"
5
6# UUID from database/application
7user_id = "0000-0000-0000"
8
9composio = Composio()
10
11
12def authenticate_toolkit(user_id: str, auth_config_id: str):
13 # Replace this with a method to retrieve the Bearer Token from the user.
14 bearer_token = input("[!] Enter bearer token")
15 connection_request = composio.connected_accounts.initiate(
16 user_id=user_id,
17 auth_config_id=auth_config_id,
18 config={"auth_scheme": "BEARER_TOKEN", "val": bearer_token}
19 )
20 print(f"Successfully connected Googleslides for user {user_id}")
21 print(f"Connection status: {connection_request.status}")
22
23 return connection_request.id
24
25
26connection_id = authenticate_toolkit(user_id, googleslides_auth_config_id)
27
28# You can verify the connection using:
29connected_account = composio.connected_accounts.get(connection_id)
30print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Googleslides toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["GOOGLESLIDES"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Update Presentation (Batch/Markdown)

Description

Tool to update existing google slides presentations with either raw api requests or markdown content. **two operation modes:** 1. **raw api mode**: provide direct slides api requests for precise control 2. **markdown mode**: provide markdown text to automatically add professional slides **markdown features:** - professional themes with coordinated colors and backgrounds - dynamic font sizing that prevents overflow (notion-like hierarchy) - smart table auto-sizing with column width optimization - auto-centering and professional positioning - bold formatting, emojis, and multi-line content support - multiple slide types: title, bullet, table, quote, image, two-column **use cases:** - add new slides to existing presentations - update presentation content with markdown - apply professional themes and styling - bulk slide creation with consistent formatting

Action Parameters

markdown_text
string
presentationId
stringRequired
requests
array
writeControl
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Google Slides Presentation

Description

Tool to create a blank or duplicate presentation. use when you need to initialize a presentation with a specific title or duplicate an existing one.

Action Parameters

duplicatePresentationId
string
presentationId
string
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Presentation

Description

Tool to retrieve the latest version of a presentation. use after obtaining the presentation id.

Action Parameters

fields
string
presentationId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Presentation Page

Description

Tool to get the latest version of a specific page in a presentation. use when you need to inspect slide, layout, master, or notes page details.

Action Parameters

pageObjectId
stringRequired
presentationId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Slides from Markdown

Description

Creates a new google slides presentation from markdown text. automatically splits content into slides using '---' separators and applies appropriate templates based on content structure.

Action Parameters

markdown_text
stringRequired
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Page Thumbnail

Description

Tool to generate and return a thumbnail image url for a specific page. use when you need a quick preview of a slide page after loading it.

Action Parameters

pageObjectId
stringRequired
presentationId
stringRequired
thumbnailProperties.mimeType
string
thumbnailProperties.thumbnailSize
string

Action Response

data
objectRequired
error
string
successful
booleanRequired