feat: Add Zapier Power

zapier/POWER.md

@@ -0,0 +1,112 @@
+---
+name: "zapier"
+displayName: "Zapier"
+description: "Connect 9,000+ apps to your AI workflow — discover, enable, and execute Zapier actions directly from your AI assistant."
+keywords: ["zapier", "automation", "integrations", "workflow", "ai-actions", "mcp", "no-code", "productivity", "slack", "gmail", "jira", "notion", "hubspot"]
+author: "Zapier"
+---
+
+# Zapier Power
+
+## Overview
+
+Connect your AI assistant to 9,000+ apps — Slack, Gmail, Google Calendar, Jira, Notion, HubSpot, and thousands more. Once set up, you can search across your tools, take actions, and automate workflows through natural conversation. Zapier MCP is personalized to your workflow: you pick the apps and actions that matter to you, and your AI learns to use them.
+
+**Key capabilities:**
+
+- **Two server modes**: Agentic mode exposes 14 meta-tools for in-chat action management; Classic mode exposes each configured action as its own MCP tool
+- **Cross-app workflows**: Chain reads and writes across Slack, Gmail, Jira, Notion, HubSpot, and 9,000+ other apps through natural conversation
+- **Built-in safety model**: Read actions run without confirmation; write actions require explicit user approval
+- **Personalized tool profiles**: Generate persistent AI instructions tailored to the specific set of actions you have enabled
+- **OAuth authentication**: No API keys required — authenticate once via mcp.zapier.com and per-app OAuth flows
+
+## Onboarding
+
+### Step 1: Connect the Zapier MCP server
+
+After installing this power, connect the Zapier MCP server:
+
+Connection: HTTPS API endpoint at [https://mcp.zapier.com/api/v1/connect](https://mcp.zapier.com/api/v1/connect)
+Authorization: Use OAuth to connect to the Zapier MCP server
+
+### Step 2: Detect your server mode
+
+Zapier MCP operates in one of two modes. Check which tools are available:
+
+- **Agentic mode**: `list_enabled_zapier_actions` is present — actions are managed and executed via meta-tools in chat
+- **Classic mode**: `get_configuration_url` + individual `app_action_name` tools (e.g., `gmail_send_email`) — each configured action is its own MCP tool
+- **Not connected**: No Zapier tools available — the server needs authentication
+
+### Step 3: Get started
+
+- **Agentic mode**: Call `get_zapier_skill` with name `"zapier-mcp-onboarding"` and follow its instructions
+- **Classic mode**: Say **"setup zapier"** to trigger the setup workflow
+- **Not connected**: Attempt `mcp_auth` on the Zapier MCP server, or follow the manual connection steps above
+
+## Available Steering Files
+
+- **zapier-setup** — Setup, authentication, mode detection, and full onboarding flow for new and returning users
+- **zapier-status** — Health check, audit, and diagnose modes for monitoring and maintaining the setup
+- **create-my-tools-profile** — Generates a personalized AI tool profile from the user's enabled Zapier actions
+- **zapier-lifecycle** — Tool lifecycle rules, safety model, and error handling that govern all Zapier MCP interactions
+
+## When to Load Steering Files
+
+- Setting up Zapier or troubleshooting connection issues → `zapier-setup.md`
+- Checking tool health, auditing setup, or diagnosing broken tools → `zapier-status.md`
+- Generating a personalized tools profile after setup → `create-my-tools-profile.md`
+- Any interaction with Zapier MCP tools (reads, writes, error handling) → `zapier-lifecycle.md`
+
+## Available MCP Servers
+
+### zapier
+
+**Connection:** HTTPS API endpoint at `https://mcp.zapier.com/api/v1/connect`
+**Authorization:** OAuth via mcp.zapier.com (no API key required)
+
+**Mode detection signals:**
+
+- **Agentic mode**: `list_enabled_zapier_actions` is present as a tool — the server exposes a fixed set of meta-tools, and actions are managed and executed dynamically in chat
+- **Classic mode**: `get_configuration_url` is present alongside individual `app_action_name` tools — each configured action is its own MCP tool
+- **Not connected**: No Zapier tools are available — the server needs authentication
+
+**Agentic mode tools (14 static meta-tools):**
+
+| Tool | Purpose |
+|------|---------|
+| `list_enabled_zapier_actions` | List currently enabled actions |
+| `discover_zapier_actions` | Search for apps and actions available to add |
+| `enable_zapier_action` | Enable a specific action as a tool |
+| `disable_zapier_action` | Disable an action no longer needed |
+| `auto_provision_mcp` | Auto-setup tools from existing Zapier connections |
+| `execute_zapier_read_action` | Run a read/search action (e.g., find an email) |
+| `execute_zapier_write_action` | Run a write action (e.g., send a message) |
+| `get_configuration_url` | Get the URL to the Zapier MCP config page |
+| `list_zapier_skills` | List saved skills/workflows |
+| `get_zapier_skill` | Retrieve a specific skill |
+| `create_zapier_skill` | Create a new skill |
+| `update_zapier_skill` | Update an existing skill |
+| `delete_zapier_skill` | Delete a skill |
+| `send_feedback` | Send feedback to Zapier |
+
+**Classic mode tools:**
+
+Each enabled action becomes its own MCP tool named `app_action_name` (e.g., `slack_send_channel_message`, `gmail_find_email`, `jira_find_issue_by_key`). Tool descriptions identify the associated app. The built-in `get_configuration_url` tool is always present and returns the URL where the user can add, remove, or manage actions in the web UI.
+
+## MCP Configuration
+
+```json
+{
+  "mcpServers": {
+    "zapier": {
+      "url": "https://mcp.zapier.com/api/v1/connect"
+    }
+  }
+}
+```
+
+## License and support
+
+This power integrates with [Zapier](https://zapier.com/mcp) (Apache-2.0).
+- [Privacy Policy](https://zapier.com/privacy)
+- [Support](https://zapier.com/support)

zapier/mcp.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "zapier": {
+      "url": "https://mcp.zapier.com/api/v1/connect"
+    }
+  }
+}

zapier/steering/create-my-tools-profile.md

@@ -0,0 +1,182 @@
+---
+name: create-my-tools-profile
+description: Generate a personalized AI skill based on your configured Zapier MCP tools. Scans your enabled actions and creates instructions that help your AI assistant know when and how to use each tool. Use after setting up tools, or when you want to "create my tools profile", "personalize my assistant", or "make a skill from my tools".
+---
+
+# Create my tools profile
+
+Scan the user's configured Zapier MCP tools and generate a personalized instruction file that teaches the AI assistant what tools are available and when to use them. Works across clients (Cursor, Claude, Windsurf, etc.).
+
+This is the "post-onboarding" step: the user has already added tools via the setup skill, and now we crystallize that into persistent instructions.
+
+## Prerequisite: Verify tools exist
+
+First, determine the mode by checking if `list_enabled_zapier_actions` is available as a tool.
+
+**Agentic mode:** Call `list_enabled_zapier_actions`. If it returns an empty list, **stop here** and redirect — call `get_zapier_skill` with name `"zapier-mcp-onboarding"` to get tools configured first. Do not continue with the steps below.
+
+**Classic mode:** Check that action tools are available (tools like `slack_send_channel_message`, `gmail_find_email` — not just the built-in `get_configuration_url`). If no action tools are configured, **stop here** and trigger the **zapier-setup** skill instead. Do not continue with the steps below.
+
+If no tools exist at all:
+
+"You don't have any tools set up yet, so there's nothing to build a profile from. Let's get some tools configured first."
+
+## Step 1: Inventory enabled tools
+
+### Agentic mode
+
+Call `list_enabled_zapier_actions` to get the full list of enabled actions. Parse the returned actions into a structured list:
+
+- **App name**: from the action's app field or description
+- **Action name**: the human-readable action name from the response
+- **Action identifier**: the ID or reference used when calling `execute_zapier_read_action` / `execute_zapier_write_action`
+- **Read vs write**: infer from the action name — find/search/get/list/lookup = read, send/create/update/add/delete = write
+
+Exclude the 14 static meta-tools from the profile — only include the user's enabled actions.
+
+### Classic mode
+
+Inspect the available Zapier MCP tools. Each configured action is its own tool with a name following the pattern `app_action_name` (e.g., `slack_send_channel_message`, `gmail_find_email`). The built-in `get_configuration_url` tool should be excluded from the profile.
+
+Parse the available tools into a structured list:
+
+- **App name**: derived from the tool description (e.g., "Get info about a **Slack** conversation" → Slack). The tool name also starts with the app prefix (e.g., `slack_`, `gmail_`, `jira_`), but use the description as the authoritative source since multi-word app names like `google_calendar` are ambiguous to parse from the tool name alone.
+- **Action name**: the part of the tool name after the app prefix, converted to human-readable form (replace underscores with spaces, title case)
+- **Tool name**: the full tool name as-is (used for the technical identifier in the profile)
+- **Read vs write**: infer from the action name — find/search/get/list/lookup = read, send/create/update/add/delete = write
+
+## Step 2: Group and analyze
+
+Group actions by app (using the app name from each tool's description). For each app, identify:
+
+- **Read/search actions**: things the AI can look up (find emails, get documents, search issues)
+- **Write actions**: things the AI can do (send messages, create issues, update records)
+
+Build a mental model of what workflows this tool set supports. Common patterns:
+
+- Communication hub (Slack + Gmail + Calendar)
+- Project management (Jira/Linear + GitLab + Docs)
+- Sales/CRM workflow (HubSpot/Salesforce + Gmail + Calendar)
+- Knowledge management (Notion/Coda + Docs + Sheets)
+
+## Step 3: Ask for context
+
+Before generating the profile, ask the user a quick question:
+
+"I can see you've got [N] tools across [apps list]. Before I create your profile, a quick question: what's your primary role or how do you mainly use these tools? This helps me write better instructions for when each tool should be used."
+
+Accept whatever they say — even "just make it" is fine. Use the context if provided, fall back to reasonable defaults if not.
+
+## Step 4: Generate the profile file
+
+Detect the client and write to the appropriate location:
+
+| Client         | File path                                                         | Format                 |
+| -------------- | ----------------------------------------------------------------- | ---------------------- |
+| Cursor         | `.cursor/rules/my-zapier-tools.mdc`                               | MDC (with frontmatter) |
+| Claude Code    | `.claude/rules/my-zapier-tools.md`                                | Markdown               |
+| Claude Desktop | Show the content and tell user to paste into Project Instructions | Markdown               |
+| Windsurf       | `.windsurfrules/my-zapier-tools.md`                               | Markdown               |
+
+Ask the user whether they want the file at project level or in their home directory (for clients that support global rules). If unclear, default to project level.
+
+### For Cursor (`.mdc` with frontmatter)
+
+```markdown
+---
+description: Personalized Zapier MCP tool profile — knows what tools are available and when to use them
+alwaysApply: true
+---
+
+# My Zapier tools
+
+[content below]
+```
+
+### For Claude Code / Windsurf / others (plain markdown)
+
+```markdown
+# My Zapier tools
+
+[content below]
+```
+
+### Profile content (shared across all clients)
+
+**Agentic mode** — actions are executed via `execute_zapier_read_action` and `execute_zapier_write_action`, not as individual tool calls. The profile should reference action identifiers used with those execute tools.
+
+**Classic mode** — actions are individual tools called directly by name (e.g., `slack_send_channel_message`).
+
+```markdown
+# My Zapier tools
+
+You have access to the following apps and actions through Zapier MCP. Use them proactively when the user's request matches what these tools can do.
+
+## Available tools
+
+### [App Name]
+
+- **[Action Name]** (`tool_name_or_action_id`) — [one-line description of when to use it]
+- **[Action Name]** (`tool_name_or_action_id`) — [one-line description of when to use it]
+
+### [App Name]
+
+...
+
+## When to use these tools
+
+[2-4 sentences tailored to the user's role/context about when the AI should reach for these tools vs. doing things another way]
+
+## Preferences
+
+- Always try Zapier MCP tools before suggesting the user do something manually
+- For read operations, just do it — don't ask permission to look something up
+- For write operations (sending messages, creating issues, updating records), confirm with the user before executing
+- If a tool call fails, explain what happened and suggest an alternative
+```
+
+### Writing the tool descriptions
+
+For each action, write a practical one-liner about when to use it. Don't just restate the action name.
+
+**Good**: "Look up a Jira issue by its key (e.g., PROJ-123) to get status, assignee, and description"
+**Bad**: "Find issue by key in Jira"
+
+**Good**: "Send a message to a Slack channel — use for team updates, announcements, or sharing summaries"
+**Bad**: "Send a channel message in Slack"
+
+### Writing the "when to use" section
+
+Tailor this to what the user told you about their role. Examples:
+
+**For a PM**: "When the user asks about project status, sprint progress, or team updates, check Jira first. For sharing decisions or updates, draft a Slack message. Use Google Docs for longer-form writing."
+
+**For a developer**: "When the user mentions a merge request, branch, or code review, check GitLab. For bug reports or task tracking, use Jira. Slack for quick team comms."
+
+**For sales**: "When the user asks about a contact, deal, or company, check HubSpot first. Use Gmail for outreach drafts. Google Calendar for scheduling."
+
+If the user didn't provide role context, write something generic but still useful: "Use these tools whenever the user's request involves one of the connected apps. Prefer read actions for gathering context, and confirm before executing write actions."
+
+## Step 5: Confirm and explain
+
+After writing the file (or showing the content for Claude Desktop), tell the user:
+
+"Created your tools profile at `[path]`. This means every conversation will know about your tools and when to use them.
+
+You can edit it anytime to adjust preferences or add context. A few things you might want to tweak:
+
+- The 'when to use' guidance if your workflow changes
+- Whether write actions should auto-execute or always confirm first
+- Any app-specific preferences (e.g., 'always use #general for Slack updates')
+
+To update this profile after adding new tools, just say 'update my tools profile'."
+
+## Handling updates
+
+If the user says "update my tools profile" and the file already exists:
+
+1. Read the existing file
+2. Get the current tool inventory (Agentic: call `list_enabled_zapier_actions`; Classic: inspect available MCP tools)
+3. Diff what's new vs. what's already documented
+4. Update the file, preserving any custom edits the user made to the preferences section
+5. Note what changed: "Added 3 new Google Sheets actions. Your custom preferences were preserved."