Hooklistener

MCP setup · Claude

Hooklistener MCP server for Claude.ai and Claude Desktop

In Claude, go to Customize → Connectors, click + and choose Add custom connector, paste https://app.hooklistener.com/api/mcp and click Add, then Connect and sign in to Hooklistener. The connector belongs to your Claude account, so it works on claude.ai, in Claude Desktop and in the mobile apps with no config file. Turn it on per chat from the + button → Connectors.

Setup checked against Claude Help Center docs, September 2026

Claude → Customize → Connectors
1. Click "+" → "Add custom connector"
2. URL: https://app.hooklistener.com/api/mcp
3. Click "Add"
4. Click "Connect" → sign in to Hooklistener → Authorize
Where
Customize → Connectors
Plans
Free (one custom connector), Pro, Max, Team, Enterprise
Sign-in
OAuth; leave Advanced settings empty
Works in
claude.ai, Claude Desktop, Cowork, mobile
Per chat
+ → Connectors toggle

Setup

Connect Claude step by step

  1. 01

    Add the connector

    On Pro and Max, open Customize → Connectors, click + and choose Add custom connector. Paste the URL and click Add. You can leave Advanced settings (OAuth Client ID and Secret) empty; Hooklistener registers Claude automatically.

  2. 02

    Team and Enterprise: the owner adds it first

    Only Owners can add custom connectors to a Team or Enterprise organization: Organization settings → Connectors → Add → Custom → Web, paste the URL, click Add. Members then find it under Customize → Connectors and click Connect.

  3. 03

    Connect and sign in

    Click Connect. Hooklistener's consent page opens; pick the organization and click Authorize. Claude never sees your password.

  4. 04

    Turn it on in a chat

    Click + at the lower left of the chat box, open Connectors and switch Hooklistener on. Claude asks before each tool call until you allow it.

Read-only access

Custom connectors have no scope setting, so Claude receives the default full-access grant. The consent page shows what it covers. To keep a chat to inspection, approve tool calls one at a time instead of choosing Allow always, and keep Allow always for read tools like list_requests and get_request.

Try it

What to ask Claude

Plain-language requests work; Claude picks from Hooklistener's 67 tools. These are the ones each prompt usually calls.

What changed in my Stripe webhooks this week? Any new event types or missing fields?

Hourly anomaly detection flags new event types, missing fields, type changes and silent senders; Claude summarizes them.

  • list_endpoints
  • list_endpoint_anomalies

Find the webhook for order 8812 and explain in plain English why our server rejected it.

Useful for support and product people who don't live in a terminal.

  • list_requests
  • get_request
  • diagnose_request

Set up an uptime monitor on api.example.com/health and tell me if it's been down today.

Claude creates the monitor and reads its status back later in the same chat.

  • create_monitor
  • get_monitor_status

Did the welcome email go out to my test inbox, and does it mention the trial length?

Claude reads the captured email and checks the copy for you.

  • list_inboxes
  • list_emails
  • get_email

Troubleshooting

When Claude doesn't connect

You can't add a second custom connector
Free plans are limited to one custom connector. Remove the other one or upgrade your Claude plan.
You changed the URL and it still points at the old one
Custom connectors can't be edited in place. Remove the connector and add it again with the new details.
You edited claude_desktop_config.json and nothing happened
That file is for local MCP servers in Claude Desktop and is a separate mechanism. Hooklistener is remote: add it as a custom connector and Desktop picks it up from your account.
The connector is added but Claude doesn't use it
Connectors are switched on per conversation. Open + → Connectors in the chat and enable Hooklistener.

FAQ

Claude and Hooklistener: common questions

Does Claude Desktop need a config file for Hooklistener?

No. Remote connectors are configured in your Claude account and brokered by Anthropic's servers, so Claude Desktop picks up the custom connector you add under Customize → Connectors.

Can I use Hooklistener in Claude on the free plan?

Yes. Claude's free plan allows one custom connector, and Hooklistener's MCP server works on its free plan too.

Why does Claude connect from the cloud and not from my computer?

Custom connectors connect from Anthropic's infrastructure on every Claude client. Hooklistener is a public hosted server, so that's fine; your localhost is reached through the Hooklistener CLI, not through Claude.

How is this different from the Claude Code setup?

Claude Code adds servers with claude mcp add and keeps them in ~/.claude.json or .mcp.json. Claude.ai and Desktop use account-level custom connectors instead. Both use the same Hooklistener URL and OAuth sign-in.

Keep going

More on the MCP server

Server URL: https://app.hooklistener.com/api/mcp

Other clients

Set up Hooklistener in another tool

Give Claude a webhook URL it can watch

The free plan includes the MCP server, 1 debug endpoint, 1 email inbox and 1 uptime monitor. No credit card.

Start freeSee all MCP tools