Illustration of what sdk does: Docs, verified examples and agent skills for calling Zapier's apps from code

zapier /

sdk

Docs, verified examples and agent skills for calling Zapier's apps from code

Open on GitHub (opens in a new tab) Website (opens in a new tab)

The Zapier SDK is an npm package that lets your code or AI agent call actions in apps like Notion, Gmail, Google Sheets and Airtable. Zapier holds the OAuth grants, so your code never touches a token. You log in once, create a connection per app, then run actions from TypeScript or the command line.

This repo is the companion material. It has a library of examples sorted by app, by domain and by pattern (such as notify-on-event, data-sync and lead-routing). Each example's action keys were checked against Zapier's live action list, so agents are less likely to invent method names.

It also ships a skill and a read-only explorer subagent for Claude Code, OpenAI Codex and GitHub Copilot CLI. The README names Zapier MCP as the alternative if you want an MCP server for tool calling. The SDK and CLI live in separate npm packages, and use of the Zapier service is governed by Zapier's own terms.

What it does

  • Run actions through connections

    After you create a connection with the CLI, run-action calls an action in that app and returns JSON. Connections use OAuth that Zapier stores for you.

  • Examples in three indexes

    Examples are grouped by app, by domain and by automation pattern. The README says every action key was checked against listActions.

  • The zapier-sdk skill

    This skill teaches an agent how to authenticate, discover apps and actions at runtime, and what to use when no first-class action exists. It follows the agentskills.io format.

  • Read-only explorer subagent

    The zapier-sdk-explorer subagent looks up exact app, action and field IDs in the live catalog before your agent writes code.

  • Escape hatch for any HTTP API

    The README's architecture diagram shows sdk.fetch as a way to reach an API that has no ready-made action.

What you could build

  • Search Notion pages or Gmail messages from a script using an existing OAuth connection.
  • Look up a Google Sheets row or an Airtable record by field value from the command line.
  • Build a lead-routing or data-sync automation by starting from a pattern example.
  • Give a coding agent the Zapier skill so it writes SDK code with correct action keys.
  • Let a backend call a user's connected apps without storing their tokens.

Get started

Install the SDK and CLI, log in with the CLI, then create a connection for an app (this opens a browser for OAuth). After that, run-action calls any action in that app.

npm install @zapier/zapier-sdk npm install -D @zapier/zapier-sdk-cli @types/node typescript
npx zapier-sdk login
npx zapier-sdk create-connection notion

Commands are copied from the project's README. Read it on GitHub for the full setup.

More in Agent skills & plugins

See all
superpowers A set of skills that makes coding agents plan, test and review before they write code 303.8k9.7k mattpocock/skills Small, editable agent skills for planning, testing and reviewing code with AI 301k26.9k ECC Agents, skills, hooks and memory that add an engineering workflow to coding agents 286.6k15.8k andrej-karpathy-skills A CLAUDE.md file that tells Claude Code to ask first, keep code small, edit narrowly 222.6k6.2k anthropics/skills Anthropic's example Agent Skills: folders of instructions Claude loads per task 183.1k3.7k ponytail A skill that makes AI coding agents write the least code that works 173.7k22.8k gstack Slash-command skills that give Claude Code roles like reviewer, QA and release engineer 137.3k2.6k addyosmani/agent-skills A pack of 25 Markdown skills that guide AI coding agents from spec to ship 109.7k9.3k taste-skill Agent skills that steer AI coding tools toward better layout, type and motion 101.2k9.3k archify Agent skill that turns a description or a codebase into an interactive HTML diagram 87.8k11.8k

    ↑↓ to move, Enter to open, Esc to close