Connector guide2-minute read9 MCP toolsEnglish · Deutsch · Italiano

How to Connect Nutshell CRM to ChatGPT — via MCP

Manage Nutshell CRM (leads, contacts, accounts, activities, tasks) from any AI agent. 9 tools, basic-auth with API token.

HCBy HelpCode teamUpdated 2 min read Open source on GitHub

No credit card · 7-day trial · Self-host alternative available

MCP connector

Nutshell CRM

Manage Nutshell CRM (leads, contacts, accounts, activities, tasks) from any AI agent. 9 tools, basic-auth with API token.

Tools

9

Region

INTL

Category

crm

Authentication

Required env vars

NUTSHELL_USERNAMENUTSHELL_API_KEY
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Source-available BSL-1.1
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

No install? Use cloud.anythingmcp.com directly.

Sign in, install the Nutshell CRM in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.

Open Cloud

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Nutshell CRM, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Nutshell CRM + ChatGPT

Manage Nutshell CRM (leads, contacts, accounts, activities, tasks) from any AI agent. 9 tools, basic-auth with API token.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

NUTSHELL_USERNAME, NUTSHELL_API_KEY

Step 1 — Get credentials

This connector wraps the Nutshell REST API v1 (app.nutshell.com/api/v1).

Setup:

  1. Log into https://app.nutshell.com → top-right avatar → Setup → API → New API key.
  2. Note the Username (your Nutshell email) and the generated API key.
  3. Set NUTSHELL_USERNAME (email) and NUTSHELL_API_KEY.

Authentication: HTTP Basic — username = your account email, password = the API key. Nutshell ALSO supports a legacy JSON-RPC API but the REST endpoints exposed here are easier to consume.

Entity types: Lead (the main pipeline opportunity), Contact (person), Account (company), Activity (call/meeting log), Task (todo). Each has its own endpoint root.

…(continued in the in-app connector instructions)

Step 2 — Install the adapter

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Step 3 — Add the connector in ChatGPT

ChatGPT supports MCP servers via the Connectors feature (Plus / Pro / Team / Enterprise plans). The free tier does not support custom connectors.

  1. Open ChatGPT → Settings → Connectors (or click the 🔧 icon in the composer → Manage connectors).
  2. Click "Add custom connector".
  3. Fill in:
    • Name: Nutshell CRM
    • MCP server URL: https://cloud.anythingmcp.com/mcp
    • Authentication: Bearer token → paste your MCP API key (from AnythingMCP → Profile → MCP API Keys → New Key)
  4. Click Connect to authorize.

Available tools

ToolWhat it does
nutshell_list_leadsList leads
nutshell_get_leadGet one lead by ID with full custom fields, products, activities
nutshell_create_leadCreate a lead
nutshell_list_contactsList contacts
nutshell_create_contactCreate a contact
nutshell_list_accountsList accounts (companies)
nutshell_create_accountCreate a company
nutshell_list_activitiesList activities (calls, meetings, emails, log notes)
nutshell_create_taskCreate a task assigned to a user, optionally linked to a lead/contact/account

FAQ

Does ChatGPT free tier work with custom MCP connectors? No — Plus, Pro, Team or Enterprise required.

Next steps

Ready to ship

Your Nutshell agent is one click away.

Install the connector, paste the key, prompt ChatGPT. Free for 7 days, no credit card.