How to Connect Nutshell to Claude (and What It Can't Do)
Nutshell did something most CRMs its size haven’t: it built and hosts its own official MCP server, included with every Nutshell plan at no extra cost. Connecting Claude takes about two minutes and zero code. The trade-off is stated plainly in Nutshell’s own help docs: the server is read-only. Claude can see everything in your Nutshell account and change none of it — no creating leads, no logging activities, no advancing a lead through a stageset.
That single design decision shapes everything below, so it’s worth being precise about what “connected” gets you.
Two-minute setup
- In Claude, open your avatar menu → Settings → Connectors, and add a custom connector. (Nutshell’s docs note this requires a paid Claude account.)
- Name it Nutshell and enter the server URL:
https://app.nutshell.com/mcp - Click Connect, log into Nutshell, and approve access on the consent page.
- Confirm via Claude’s Connections button that the server shows as enabled.
No API keys, no self-hosted anything — Nutshell runs the server, and it’s the same URL for every account.
The questions it answers well
Read-only still covers a lot of ground for a sales team: leads, people, companies, users, pipelines and stagesets, and reporting are all queryable. The pattern that works is analytical — Nutshell itself pitches examples like “Which deals over $5,000 are at risk this week?” Others in the same vein:
- “Which open leads over $5,000 in the Outbound stageset have had no activity logged this week?”
- “Summarize win rate by lead source for Q2 and flag anything that dropped from Q1.”
- “Who owns the leads stalled in the Demo Scheduled stage, and how long has each one sat there?”
For pipeline reviews, forecast sanity checks, and Monday-morning triage, this is genuinely quicker than building the equivalent report inside Nutshell.
Two ceilings, one obvious and one not
The obvious ceiling is the read-only wall. Claude can identify the stalled lead but can’t nudge its stage; it can spot that a call went unlogged but can’t log it; it can draft a follow-up in the chat window but can’t attach it to the lead. If you want chat-based writes to Nutshell, you’d have to go around the official server to a third-party one — Composio’s Nutshell toolkit, for instance, wraps Nutshell’s API with write actions — accepting third-party code in exchange.
The less obvious ceiling applies to both routes: a Claude connector functions only inside a conversation someone is actively having. A lead entering the Negotiation stage on Friday afternoon produces no summary, no alert, no task — until a human opens a chat and asks. Nothing in the connector model listens for Nutshell events, on any server, official or not.
Put together: Claude + Nutshell is a superb insights console and, by design, nothing more.
Getting the writes and the follow-through: Carly
The layer Nutshell’s server deliberately leaves out — acting on the data, at the moment things change — is where Carly comes in. Carly is an AI executive assistant that runs in the cloud and works from triggers: a prospect replies, a lead sits idle past a threshold, a meeting ends, and she executes — updating the CRM, logging the activity, creating the task, drafting and sending the email through Gmail or Outlook with attachments.
Instead of configuring automations, you describe the outcome (“follow up on quiet leads and keep Nutshell updated”) and Carly interviews you, then builds the workflow with you. AI agents start at $35/month, and steps in a workflow that don’t use AI run free and unlimited. She connects to 200+ tools across 40+ categories — see integrations and the Nutshell integration page.
Official Nutshell MCP vs Carly
| Claude (Nutshell’s MCP server) | Carly | |
|---|---|---|
| Search leads, people, pipelines | Yes | Yes |
| Pipeline & win-rate reporting | Yes | Yes |
| Create or update a lead | No — server is read-only | Yes |
| Log activities automatically | No | Yes |
| Reacts when a lead changes stage | No | Yes |
| Vendor-hosted, zero setup | Yes | Yes |
| Working while you sleep | No | Yes (cloud) |
| Cost | Free with Nutshell + paid Claude plan | AI agents from $35/mo |
Frequently Asked Questions
Does Claude integrate with Nutshell?
Yes — Nutshell hosts an official MCP server at app.nutshell.com/mcp that you add to Claude as a custom connector (paid Claude plan required; the server itself is free on all Nutshell plans). It gives Claude read access to your leads, contacts, pipelines, and reports.
Can Claude create or edit leads in Nutshell?
Not through the official server — Nutshell built it read-only, so your account can’t be changed by the AI. Third-party MCP servers that wrap Nutshell’s API with write actions exist, but then you’re trusting non-Nutshell code with CRM credentials.
Is the Nutshell MCP server really free?
Yes: Nutshell includes it on every plan with no usage limits or per-query fees. Your only subscription cost on the AI side is the paid Claude plan the connector requires.
Will Claude alert me when a big lead stalls?
No. Connectors don’t monitor anything — they answer inside a chat you start. To get action when a lead stalls or a prospect replies, you need a trigger-driven agent like Carly, which fires on events 24/7 in the cloud.
What’s the best pairing in practice?
Many teams land on both: Nutshell’s official server for ad-hoc pipeline questions in Claude, and Carly for the standing workflows — logging, updating, and following up as events happen. AI agents start at $35/month.
More: Claude connectors · Claude + Google Calendar · Can Claude send emails · Claude vs Carly · Best AI CRM tools · Claude + Salesflare · Claude + NetHunt CRM · Claude + Salesmate
Ready to automate your busywork?
Carly schedules, researches, and briefs you—so you can focus on what matters.
See what people say
"Before Carly, I relied on a Calendly link, but the whole process felt impersonal and not very professional. Carly changed that by handling all the back-and-forth, so I'm no longer stuck in endless email threads trying to line up schedules.
Now Carly reaches out to candidates, shares my real-time availability, lets them pick a slot, then sends a Zoom link and drops it straight into my calendar. She sends reminders to both of us before each call, which has significantly reduced no-shows and last-minute confusion.
On top of scheduling, Carly acts like a full executive assistant, sending me my schedule the night before so I can prepare for each call. It reminds me of the old x.ai assistant, but Carly is noticeably smarter, faster, and better suited to my healthcare recruitment business."
