Skip to main content

Connect Swipe One to Claude (MCP)

Connect your Swipe One workspace to Claude so you can build segments, write on-brand emails, and run campaigns by asking for them.

Written by Support Team - Swipe One

Connect your Swipe One workspace to Claude and you can get marketing work done by asking for it. Claude reads your contacts, builds segments, writes emails in your brand's voice, and sets up campaigns, all inside your workspace, with you approving each step.

This runs on MCP (Model Context Protocol), an open standard for connecting AI assistants to the tools you already use. You don't need to know anything more about it than the address you're about to paste.

Once you're connected, you can ask for things like:

  • "Build a segment of contacts who opened an email in the last 90 days but never clicked a link."

  • "Write a launch announcement for our Active Customers segment, send a test to my inbox, then schedule it for Tuesday at 10am."

  • "Which campaigns went out last month, and which got the best click rate?"

  • "Pull up everything [email protected] has done recently before I reply to her."

Before you start

You'll need:

  • A Swipe One workspace, and access to its Settings.

  • A Claude account. Adding a custom connector is available on Claude's paid plans.

  • A verified sending domain, if you plan to actually send anything. You'll find this under Settings › Marketing Emails.

Set up your Brand Kit first. Claude reads your logo, colours, fonts and brand voice from Settings › Brand Kit, and writes every email to match. Skip it and you'll get generic-looking email. Claude will ask whether you want to go ahead with neutral defaults, which is rarely what you want. Five minutes here pays for itself on the first campaign.

Step 1: Create your API key

  1. Open Settings › API Keys. Do this inside the workspace you want Claude to work in.

  2. Click Create API Key.

  3. Give it a name you'll recognise later. "Claude" works.

  4. Copy the key. It starts with sp_.

A key belongs to one workspace. The connection you're about to make will only ever act on that workspace. It can't see or touch your others. Working across several workspaces? Create a key in each one and add a separate connection for each.

Step 2: Add Swipe One to Claude

The address you'll need: https://mcp.swipeone.com/mcp

  1. In Claude, open Settings › Connectors.

  2. Click Add custom connector.

  3. Name it Swipe One.

  4. Paste the address above.

  5. Click Add.

Step 3: Connect your workspace

  1. Claude opens a Connect Swipe One page in your browser.

  2. Paste the API key you copied in Step 1.

  3. Click Connect.

That's it. To check it worked, ask Claude: "Which Swipe One workspace am I connected to?" It should name your workspace back to you.

To disconnect later, remove the connector in Claude or delete the key in Settings › API Keys. Either one ends the connection.

What you can do

  • Find the right contacts - "Show me everyone on a trial in the UK who hasn't opened an email in 30 days."

  • Look up one person's history - "What has [email protected] done since she signed up?"

  • Build a segment - "Create a segment called Lapsed Customers: tagged churn-risk, no opens in 60 days."

  • Write an on-brand email - "Draft a re-engagement email for Lapsed Customers"

  • Test, then send or schedule - "Send a test to [email protected], then schedule it for Thursday at 9am."

  • See what worked - "How did that campaign do compared to last month's newsletter?"

  • Let Claude run the whole thing - "Build me an email campaign for our new pricing page."

One thing to expect on test sends: the test arrives from a Swipe One test address, not your own domain, and personalization tags show as written rather than filled in. The real campaign sends from your domain with every tag filled.

What's not included yet

Claude works with the data already in Swipe One. It can't change your contact records, so a few things stay in the app:

  • Adding or editing contacts. Claude reads them. Imports and edits happen in Swipe One.

  • Creating or applying tags. Claude can see your tags and segment on them, but not change who has what.

  • Notes and tasks. Not available through Claude yet.

  • Workflows/automations. This is next in the roadmap for MCP. We are actively working on this and will be shipped soon.

Troubleshooting

Claude can't connect. Check the address is exactly https://mcp.swipeone.com/mcp, including /mcp at the end.

Your key was rejected. Make sure you copied the whole key, that it starts with sp_, and that it still exists under Settings › API Keys. A deleted key stops working immediately.

Claude says the campaign isn't ready to send. Something required is missing, usually a sender name, a verified sending domain, a subject line, or an audience. Claude will tell you which. Fill in the gap and ask it to try again.

No sending domains found. You need a verified domain before any campaign will deliver. Set one up under Settings › Marketing Emails.

Claude is working in the wrong workspace. Your key was created in a different one. Create a key inside the workspace you want, then add it as a new connection.

Claude can't find a segment or contact you know exists. Check the spelling. Claude matches names exactly as they're stored in Swipe One.

Using Claude Code?

Run claude mcp add --transport http swipeone https://mcp.swipeone.com/mcp, then follow the same authorize step above.

Did this answer your question?