# Official Zapier MCP ↔ FreeAgentMaker

Connect Zapier’s hosted MCP so FreeAgentMaker agents can use actions across Zapier’s app library (Gmail, Slack, HubSpot, Notion, and more).

This is **different** from the built-in social webhook MCP (`ZAPIER_WEBHOOK_URL` → LinkedIn / Instagram / TikTok). See **[ZAPIER-SOCIAL-PUBLISHER.md](./ZAPIER-SOCIAL-PUBLISHER.md)** for that path.

## What you do in Zapier

1. Open **[mcp.zapier.com](https://mcp.zapier.com)** and sign in.
2. **+ New MCP Server** → MCP client **Other** → name it (e.g. `FreeAgentMaker`).
3. **Add tools** you actually need. Start with **reads / drafts**; add send/create later.
4. Connect each app account when Zapier prompts you.
5. Open the **Connect** tab → **Generate token** → copy it once (password-equivalent).

Endpoint (same for everyone):

```text
https://mcp.zapier.com/api/v1/connect
```

Auth: `Authorization: Bearer <token>`

## What you do in FreeAgentMaker

1. Sign in → **Integrations** → **MCP Tool Interop**.
2. Use **Fill Zapier defaults** (or paste the URL yourself).
3. Paste the connection token → **Connect Zapier MCP**.
4. Open an agent → **Model & settings** → **MCP tools** → select **Zapier MCP** → allow only the tools that agent should use → **Refresh tools**.
5. Chat in **Test chat**. Read/discovery tools may run immediately; **writes always appear under Dashboard → Pending actions** until you **Approve & run**.

Reconnecting with the same URL **updates** the stored token (no duplicate server).

## Safety defaults

| Behavior | Default |
|----------|---------|
| Zapier/MCP **write** tools (`execute_zapier_write_action`, send/create/update, enable/disable, …) | Always queued for **Pending actions** |
| Zapier/MCP **read/discovery** tools (`discover_*`, `inspect_*`, `execute_zapier_read_action`, get/list/find/…) | May run without pending approval |
| Per-agent allowlist | Required — only tools listed in `runtime.mcp.allowedTools` can run |
| Token storage | Encrypted in user preferences (`INTEGRATION_ENCRYPTION_KEY`) |

## Troubleshooting

- **400 token required** — Zapier MCP connections must include a token from the Connect tab.
- **502 initialize / tools/list failed** — Token invalid or rotated; generate a new token and Connect again.
- **Tool blocked: not in allowedTools** — Allow the tool on that agent in Model & settings.
- **Action queued** — Expected for writes; approve under Pending actions.
- **Zapier task usage** — Tool calls count against your Zapier plan, separate from FreeAgentMaker run limits.

## Related

- Webhook trigger → agent run recipes: **[ZAPIER.md](./ZAPIER.md)**
- Founder flow priorities: **[ZAPIER-PRIORITY-FLOWS.md](./ZAPIER-PRIORITY-FLOWS.md)**
- Social publish webhook MCP: **[ZAPIER-SOCIAL-PUBLISHER.md](./ZAPIER-SOCIAL-PUBLISHER.md)**