engineering / skill

Zapier SDK

Docs, examples and an agent skill for writing code against the Zapier SDK, which calls app actions through connections that Zapier holds.

At a glance

Purpose
Docs, examples and an agent skill for writing code against the Zapier SDK, which calls app actions through connections that Zapier holds.
Runs in
Local agent with shell
Operating systems
Not stated
Needs
Runtime: npm and TypeScript for SDK setup; Needs internet: Yes; Needs accounts or API keys beyond your agent: Yes
Files and data
Reads files: Yes; Writes files: Yes; Sends data to other services: Yes
Tool type
Skill
Delivery
From GitHub
Version
Latest on the main branch
Access
Code on GitHub
Compatibility
According to the README, plugin install commands are given for Claude Code, OpenAI Codex and GitHub Copilot CLI. Cursor and other assistants can load the skill, which the README says conforms to a published skills format that any conformant runtime can load directly. The README's install commands include npm packages and TypeScript.
External costs
The repository is MIT-licensed. The README says that license covers the code only, and it points to a Zapier product page for pricing without stating any. Using the Zapier service through the SDK is governed by the Zapier Terms of Service or another agreement with Zapier. Your coding agent or model provider may charge for usage.
Permissions
The skills act through your coding agent with the access you give it. The README shows npm installation of the SDK, CLI, @types/node and TypeScript, plus plugin installation for Claude Code, Codex and GitHub Copilot CLI. For assistants without native skill support, the README instructs users to clone the repository and reference SKILL.md from an assistant rules or instructions file. The README says login credentials are stored on your machine and each create-connection command opens a browser for OAuth. The README describes API calls on behalf of a user through connections held by Zapier and describes zapier-sdk-explorer as read-only.
Usage terms
MIT License, as stated in the repository. See its LICENSE file for the exact terms. The README says the MIT license covers the code only, and that using the Zapier service and APIs through the SDK is governed separately by the Zapier Terms of Service or another agreement with Zapier.

Code on GitHub

zapier/sdk

MIT

264 stars7 forksLast pushed 31 Jul 2026 UTC

Agent-readable docs, verified examples, and skill manifest for @zapier/zapier-sdk

Topics: ai-agents api-client automation integrations oauth sdk typescript workflow-automation

Public GitHub data fetched · 0 days old

Skill folders in this repository (1)

Folders that contain a SKILL.md file, from GitHub's file list on .

View on GitHub ↗

What it does

This repository bundles docs, examples and installable agent skills for @zapier/zapier-sdk, an npm package. The README describes programmatic access to Zapier's app ecosystem and says Zapier holds OAuth grants and resolves action schemas at runtime.

The README says an agent installing the plugin receives the zapier-sdk skill, a read-only zapier-sdk-explorer subagent for resolving app, action and field IDs against the live Zapier catalog, and an examples corpus whose action keys are checked against listActions. The README says the skill covers authentication, runtime discovery of apps and actions, running actions and an escape hatch when there is no first-class action.

The README says the examples folder is indexed by app, domain and pattern. Its getting-started steps install the package, log in with the zapier-sdk CLI, create an app connection through a browser and run an action from the command line.

Who it is for

Developers who want their code or coding agent to call apps through the Zapier SDK.

Example tasks

Install @zapier/zapier-sdk and log in with the zapier-sdk CLI.
Create a connection to an app such as Notion or Gmail.
Run an action from the command line with the run-action command.
Ask the zapier-sdk-explorer subagent to resolve exact app, action and field IDs before writing code.
Browse the examples by app, by domain or by pattern.

Getting started

The README's getting-started steps are: run npm install @zapier/zapier-sdk and npm install -D @zapier/zapier-sdk-cli @types/node typescript; log in with npx zapier-sdk login and check with npx zapier-sdk get-profile; add a connection, for example with npx zapier-sdk create-connection notion; then call an action with the run-action command. To install the agent plugin, the README gives, for Claude Code, /plugin marketplace add zapier/marketplace and /plugin install sdk@zapier. For OpenAI Codex it gives codex plugin marketplace add zapier/marketplace and codex plugin add sdk@zapier. For GitHub Copilot CLI it gives copilot plugin marketplace add zapier/marketplace and copilot plugin install sdk@zapier. The README has the exact commands.

Limitations

The README says every action needs a connection, an OAuth grant that Zapier holds for the app, and that each create-connection command opens a browser. You log in once with the zapier-sdk CLI. The README's install commands add the SDK, its CLI, @types/node and typescript with npm. It says using the Zapier service and APIs through the SDK is governed separately by the Zapier Terms of Service or another agreement with Zapier. The README says conformant runtimes can load the skill directly. For tools without native support for its skills format, it says to clone the repository and reference skills/zapier-sdk/SKILL.md from the assistant's rules or instructions file. The repository can change at any time; check its README before you install.

Data practices

The README says Zapier holds the OAuth connections and the live action catalog, the SDK talks HTTPS to the Zapier platform, and credentials from login are stored on your machine. It does not describe telemetry or retention. Use of the Zapier service is governed by the Zapier Terms of Service or another agreement with Zapier. What your coding agent and model provider receive depends on how you use the skills.

Community experience

Not rated yet

Sign in to share your experience.

Comments 0

No comments yet.

Sign in to comment

Report a listing concern