Google Slides

GoogleSlidesTools enable an Agent to create, manage, and manipulate Google Slides presentations. Add slides with various layouts, insert text boxes, tables, images, and videos, read slide content, and manage slide order.

Getting Started

uv pip install agno google-api-python-client google-auth-httplib2 google-auth-oauthlib openai

export GOOGLE_CLIENT_ID=your_client_id_here
export GOOGLE_CLIENT_SECRET=your_client_secret_here
export GOOGLE_PROJECT_ID=your_project_id_here

GoogleSlidesTools(credentials_path="path/to/credentials.json")

export GOOGLE_SERVICE_ACCOUNT_FILE=/path/to/service-account-key.json

GoogleSlidesTools(service_account_path="path/to/service-account.json")

export OPENAI_API_KEY="your-openai-api-key"

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.google.slides import GoogleSlidesTools

agent = Agent(
    name="Slides Assistant",
    model=OpenAIResponses(id="gpt-5.5"),
    tools=[GoogleSlidesTools()],
    instructions=[
        "You are a Google Slides assistant.",
        "Always call get_presentation_metadata before modifying slides.",
        "Use slide_id values returned by the API -- never guess them.",
        "Return both id and url with any additional text.",
    ],
    markdown=True,
)

agent.print_response(
    "Create a new Google Slides presentation titled 'Q3 2026 Business Review'. "
    "Then add a TITLE slide with title 'Q3 2026 Business Review' and subtitle "
    "'Prepared by the Strategy Team'.",
    stream=True,
)

Toolkit Params

Toolkit Functions

Presentation Management

Reading Slides

Creating & Modifying Slides

Position and size parameters (x, y, width, height) are in inches; the toolkit converts them to Google Slides EMU units.

Destructive Operations

These tools are disabled by default. Pass delete_presentation=True or delete_slide=True to enable them.

You can use include_tools or exclude_tools to modify the list of tools the agent has access to. Learn more about selecting tools.

Cookbook Examples

The slides cookbook covers four scenarios:

Slide Layouts

The add_slide function supports the following Google Slides predefined layouts:

Shared Google authentication

The current Google Workspace toolkits accept auth=AuthConfig(...) through their shared base class. Reuse one config across Drive, Sheets, Slides, or Calendar toolkits to aggregate the scopes before the first authentication:

from agno.tools.google.auth import AuthConfig

auth = AuthConfig(interactive=False, http_timeout=60)

Pass auth=auth to each toolkit constructor. This headless configuration requires existing usable credentials; it raises instead of opening a browser when interactive authorization would be needed. For an initial local OAuth sign-in, use interactive=True with the client credentials described above.

AuthConfig also accepts a supported db for token storage. Encryption is enabled by default and requires a token_encryption_key (or GOOGLE_TOKEN_ENCRYPTION_KEY). Its database token identity is shared for this Google configuration; it does not automatically select credentials by the agent's user_id. Put service-account and delegated-user settings on AuthConfig when using auth=, rather than mixing those legacy constructor arguments. Service accounts must have the target resources shared with them or appropriate delegated access.

See the AuthConfig source for the full configuration.

Developer Resources

• Source
• Cookbook