Connect Claude or Another AI Assistant

Let an AI assistant read your events and help you update them, using the same API key other tools use.

Back to developers

An AI assistant such as Claude can look at your events and help with the busywork: list who has registered, add a batch of speakers from a document, draft sessions, or check what's on an agenda. You ask in plain words and the assistant does the lookups for you. It connects to Shoal with an API key, the same kind other tools use.

Set it up

  1. Open the API page from the menu and create a key. Give it a name like "Claude" so you remember what it is for. Copy the key right away, because Shoal shows it only once.
  2. Add Shoal to your assistant as a remote server using the address below. Your assistant needs to be able to send your key along with each request (it calls this a header named Authorization with the value Bearer followed by a space and your key).
  3. Ask something simple first, like "List my Shoal events."

The server address is:

https://www.shoalevents.com/api/mcp

Claude Code

Run this once in your terminal, replacing YOUR_KEY with your API key:

claude mcp add --transport http shoal https://www.shoalevents.com/api/mcp --header "Authorization: Bearer YOUR_KEY"

Claude Desktop and other apps

Any app that lets you add a remote server by address and set a custom header can use Shoal. Enter the address above, add a header named Authorization with the value Bearer YOUR_KEY, and save. Where to find that setting depends on the app, so look for something like Add MCP Server or Custom Connector in its settings.

What the assistant can do

  1. Read your events, attendees, speakers, sessions, tracks, sponsors, audiences, pages and notifications.
  2. Create events (always as drafts) and add or update attendees, speakers, sessions, tracks, sponsors, audiences, pages and notifications.
  3. It can't delete anything, and it never sends emails. Invitations and tickets still go out only when you send them from the Attendees screen. A notification it adds can show in the attendee app and on phones, so check before you let it send one.

Next: Create a key and find your event id

Plan your next event on Shoal

Your first 2 events of up to 50 people are free if you create them before January 1, 2027.