Connections

Accounts, connectors, the gallery, skills, the browser and running code.

Google Sheets#

With Google connected, tasks and routines can read a range of a spreadsheet and add rows to it (sheets.read, sheets.append): log expenses, habits or orders, or read a list to act on. Name the spreadsheet by its address. Turn on the Google Sheets API in your Google Cloud project; if you connected Google before this, sign in again to allow spreadsheets. Added rows can be undone in Activity.

Spotify#

Connections › Spotify lets tasks and routines see what is playing, play a song, playlist, album, artist or podcast by name, pause and set the volume, on any of your Spotify devices ("play my news podcast on the living room speaker at 8", "pause the music when a meeting starts"). Create an app at developer.spotify.com, add the address Pimpo shows under Redirect URIs, and paste its Client ID; no secret is needed. Controlling playback needs Spotify Premium.

Apple Reminders, Notes and Calendar#

On a Mac, Connections › Apple Reminders, Notes and Calendar lets tasks and routines use Apple's own apps: add a reminder that rings on your iPhone and Watch, mark one done, list the open ones; search your notes and add to a note in Pimpo's folder; read the Mac's Calendar. Give the Notes folder Pimpo writes in (created if missing) and, if you like, the default Reminders list. The first time, macOS asks to let Pimpo use each app (System Settings › Privacy & Security › Automation). Reminders added and notes changed can be undone in Activity. When this is connected, "remind me tomorrow at 9" goes to the Reminders app.

More connectors#

Web pages: a task or routine can read any web page (web.read): its title, its text without menus' scripts and styles, the structured data shops publish (the product's price, its availability) and its links. Like any web read, the first visit to a site asks you once. Some big shops (Amazon, Mercado Livre, Zoom) refuse automated reads; KaBuM and most smaller sites answer.

Web search in Connections lets Pimpo search the internet, with a Brave Search API key (free for 2,000 searches a month), a Perplexity API key (about US$5 per thousand searches, billed by Perplexity) or the address of a SearXNG instance you trust. DuckDuckGo has no official API for web results; a SearXNG instance can include it among its sources.

Connections › Explore searches the official MCP registry: hundreds of servers for files, GitHub, databases, notes, maps and more. Choose one, fill in what it asks for, and See the tools shows what it offers. Check which tools Pimpo may use and how risky each one is (irreversible ones always ask you first), then install. Add by hand takes a command or an https address you already have. See Writing a connector to write your own.

A service with a REST API needs no program and no recompiling: describe its requests in a connector.json (the address, the key it needs, and for each capability the method, path and what to keep from the answer) and send it in Connections › Install connector (.json · .zip). Pimpo checks it, runs its contract and asks for the key. Writing a connector explains the format; examples/connectors/hnsearch is a complete one. If the service publishes an OpenAPI (Swagger) description, Connections › From OpenAPI writes the file for you: give its address, choose the operations and how risky each one is, fill in the key and install.

Gallery#

Browse ready-made routines, filtered by what they can touch. Pimpo checks the author's signature, runs the routine's tests, and audits what it really calls before installing. To share one of yours, use Publish on its page.

Skills#

Skills written for OpenClaw, Hermes or agentskills.io (a folder with a SKILL.md) teach the agent how to do a kind of task. Install them in More › Skills: paste a GitHub link to the skill's folder or send its .zip. Pimpo shows what the skill is, its full text, and which capabilities its text seems to need; you choose what it may use.

You do not pick a skill: the agent knows the ones installed and uses one when a task matches. From that moment, and until the task ends, it can use only the capabilities you allowed that skill; a skill allowed nothing can only guide it.

A skill is text someone else wrote, so Pimpo never treats it as your words: every action still passes your rules and approvals, the scripts it carries are not run, a skill the protection list reports is refused, and a skill changed on disk stops until you install it again.

Using sites without an API#

With Settings › Labs › Use a browser on (it needs Google Chrome), the agent can open sites, read them, follow links, fill in fields and press buttons, in a browser profile of Pimpo's own, not your usual Chrome. Use Open Pimpo’s browser in the same screen to sign in to the sites your routines should use; Pimpo never types passwords, it uses the sessions you leave there.

Reading a page and following a link change nothing. Typing and choosing are kept undoable, and pressing a button asks you first, because it may submit, buy or send. A routine can only reach the sites it names, and a page that sends it anywhere else is refused. Everything a page says is treated as the site's words, never as instructions.

Running code#

With Settings › Labs › Run code in isolation on (it needs Docker), the agent can run a short Python, JavaScript or shell program for a task, such as converting a spreadsheet or adding up a CSV. Each program runs in a fresh container with no network, no access to your files or keys, and 60 seconds at most; it gets only the files the task gives it and returns what it prints and writes. Routines can use it too, and their tests record its results like any other step.

This page is built from the repository's documentation. Improve it on GitHub.