Files
Aron PrinsandClaude Opus 5.5 c4608da865 Hotfix: Google tool names and project Environment note (v2026.1106.0) (#173)
Fixes two errors in the live docs for `v2026.1106.0`, both checked
against the tag (`d69631b0`).

- **Google tool names.** Calendar, Chat, Docs, Drive, People, Sheets,
Slides and Workspace Search listed tools with dashes, such as
`send-message`. The code and the **Permissions** tab use underscores
(`packages/shared/src/google-workspace-connectors.ts`), which is what
`gmail.md` and `google-workspace.md` already show.
- **Project Environment dropdown.** `experimental/environments.md` said
the dropdown saves the choice and the task's workspace card shows it.
Neither is reliable: `parseProjectExecutionWorkspacePolicy` drops the
value, and the card's project-default label is effectively unreachable.
The note now only says the dropdown doesn't pick where runs go.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5.5 <[email protected]>
2026-11-07 13:34:48 +01:00

6.8 KiB

paperclip_version, seo_title, seo_description
paperclip_version seo_title seo_description
v2026.1106.0 Google Slides Connector Let agents read Google Slides presentations and optionally update them. Capability groups, what editing covers, a read test, and troubleshooting.

Google Slides

Warning: Google verification pending. Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an Advanced option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [email protected] if you cannot connect.

Note: This connector is no longer listed on the Connectors page for new setup; it appears there only when you have a saved connection to it, which keeps running unchanged. For a new Google account, use Google Workspace. An agent that needs this service can still ask you for it with a connection card on its task.

Agents can read the slides and content of a Google Slides presentation, and on an editing connection update it.

Warning: Google Slides needs Google Workspace Developer Preview registration before it will authorize. Google must register the Workspace email that signs in, and the Cloud project that owns the OAuth client if you bring your own. Apply first at Google Workspace Developer Preview.

Before you connect

  • A Google Workspace account that can already open the presentations you want agents to use, with Developer Preview registration confirmed.
  • Without Paperclip Cloud enrollment, your own Google OAuth client with the Drive API, Slides API, and Slides MCP API enabled. Set up your own Google OAuth app is the complete procedure — do it before you start here.

Pick a capability group

Group What agents can do Scopes requested
Read only Read presentation slides and content presentations.readonly
Read & edit The above, plus update a presentation presentations

Neither group asks for Google Drive access. The Slides scope alone is enough to read and edit presentations the account can open, by presentation ID. Connections made with an earlier version asked for more. If a Connect with Paperclip connection from before this change stops working, select Reconnect to sign in with the smaller set. A connection using your own OAuth app keeps its earlier grant until you reconnect it.

The group is fixed for the life of the connection.

Connect Google Slides

  1. Open Connectors and select Google Slides.
  2. Read the access line above the main button. It says who the connection signs in as and which agents can use it. To pick a different identity, narrow the agents, or use another sign-in method, select Change.
  3. Check the capability group. Setup starts on the group that can make changes; to connect read-only, select Change and pick it under What should Paperclip be able to do?. Paperclip uses Connect with Paperclip when your instance offers it. To use your own client instead, select Use your own Google OAuth app and supply the client ID and secret from Set up your own Google OAuth app.
  4. Complete Google's consent screen with the registered Workspace account.

Choose access

Presentation reach comes from Google: the connection can open what the authorizing account can open. There is no file picker in Paperclip.

Reviewed operations:

Operation Group
read_presentation Both
update_presentation Read & edit only

Be realistic about what editing means here. The whole write surface is one operation, update_presentation, which applies changes through the Slides API rather than driving the Slides editor. Two consequences follow, and only the first is a capability statement:

  • Supported edits depend on the connector's operation schema. Do not assume the operation exposes every Slides API request. Inspect its current input schema before relying on a particular edit.
  • What it cannot supply is design judgement. Even where the API accepts a change, an agent placing elements without seeing the result will not arrange a slide the way a person would. Treat agent edits as a first draft that someone opens in Slides afterwards.

Note: The connector's guidance is that presentation updates should be approved. Leave update_presentation on Ask first.

Try it

Identify the presentation by its URL rather than its title, and check the answer against a deck you can open:

Read this presentation — https://docs.google.com/presentation/d/YOUR_DECK_ID/edit
— and list the title of each slide in order. Do not change it.

Compare the titles against the deck.

Warning: Do not test with "the presentation called X". The reviewed operation is read_presentation, which takes a presentation identifier — this connector has no deck-search tool, so a title-based request tests discovery rather than your connection. Title search belongs to Google Drive or Google Workspace Search.

If you want to confirm editing, do it on a copy rather than the deck someone is about to present.

Note: Illustrative task, not a recorded test result.

Troubleshooting and limitations

Problem Likely cause Fix
Google refuses before the consent screen Developer Preview registration is incomplete Finish registration and retry
Connect with Paperclip is not offered The instance is not enrolled with Paperclip Cloud, or Cloud is not advertising the Slides profile Use your own Google OAuth app
A presentation cannot be found It is not shared with the authorizing account Share it in Google Drive; no reconnect needed
update_presentation is missing The connection was made with Read only Make a connection with Read & edit
An edit landed but looks wrong The Slides API does not cover every layout and design feature Adjust it in Google Slides
Needs attention The Google token expired or was revoked Select Reconnect

Limitations: one connection covers one Google account. Creating a presentation is not part of this connector — use Google Drive with the create group. Comments and revision history are not exposed. Developer Preview applies.