Connect Grinfi to Claude AI

Control your entire outreach pipeline with natural language. Manage contacts, send LinkedIn messages, run email campaigns, and automate sequences — all from Claude.

100+ tools available

30s setup time

0 code required

Quick Connect

Connect your Grinfi account to Claude in one click. No API key needed.

Open claude.ai/customize/connectors
Click "Add custom connector"
Enter URL: https://mcp.grinfi.io
Sign in with your Grinfi credentials and select your team(s) — you can connect multiple teams and switch between them inside Claude

Requires Claude Pro, Team, or Enterprise plan

Manual Setup (API Key)

For Claude Code, Cursor, or tools that don’t support OAuth connectors. Each API key = one team. To connect multiple teams, repeat these steps with a different API key — each will be a separate connector.

Get Your Cloud Endpoint

Enter your Grinfi API key to generate a unique MCP connection URL. No installation required.

Your endpoint is ready!

Setup Instructions

Choose your Claude client and follow the steps below.

If you used Quick Connect above, you're already set! Otherwise, paste your endpoint URL:

Open claude.ai and sign in
Click your profile icon (bottom left) → Customize
Scroll to Connectors section
Click "Add custom connector"
Paste your endpoint URL below and click Connect

Your endpoint URL will appear here after you provide your API key above.

Download Claude Desktop if you haven’t already, and open it
Go to Settings (gear icon) → Customize
Scroll to Connectors and click "Add custom connector"
Paste your endpoint URL and click Connect

Alternatively, you can add it to your config file manually:

Your config will appear here after you provide your API key above.

Open your terminal
Run the following command to add the Grinfi MCP server:

Your command will appear here after you provide your API key above.

If you prefer to run the server locally on your machine (works with any Claude plan):

Go to github.com/alex-rise/grinfi-mcp-server
Download the repository (green "Code" button → "Download ZIP")
Follow the README instructions for your operating system (macOS or Windows)
The included installer will set up everything automatically — just run it and enter your API key

Open on GitHub

Want to run the server locally instead? View on GitHub

Local Installation Guide

With a free Claude plan, you can run the Grinfi MCP server locally on your computer. The installer does everything for you — including installing Node.js. Just pick your OS and follow the steps.

Step 1 Install Claude Desktop

Download Claude Desktop for Mac
Open the downloaded file and drag Claude to Applications
Launch Claude and sign in with your account

Step 2 Download the Grinfi MCP Server

Option A: Download ZIP (easiest)

Go to github.com/alex-rise/grinfi-mcp-server
Click the green "Code" button → "Download ZIP"
Unzip the file (double-click it)
Move the folder to a permanent location, for example Documents. Don’t leave it in Downloads.

Option B: Clone with Git

Open Terminal and run:

git clone https://github.com/alex-rise/grinfi-mcp-server.git

Step 3 Run the Installer

The installer does everything for you: installs Node.js (if needed), builds the server, and configures Claude Desktop automatically.

How to run it:

Open the grinfi-mcp-server folder in Finder
Double-click install.sh
The installer will ask: "Do you use multiple Grinfi teams?"
- N (default) — single team. Paste your API key and press Enter.
  Get it from Grinfi → Settings → API Keys
- Y — multiple teams. Enter each team in format teamId:apiKey and press Enter. Press Enter on an empty line when done.
  Team ID: Grinfi → Settings → Team | API Key: Grinfi → Settings → API Keys

Note: If macOS asks for permission to install Homebrew or Node.js, enter your Mac password and press Enter. This is normal.

Step 4 Start Using

Quit Claude Desktop completely (right-click the dock icon → Quit)
Reopen Claude Desktop
Look for the hammer icon at the bottom of the chat — you should see "grinfi" in the tools list
Start chatting! Try: "Show me all my Grinfi contacts"

Step 1 Install Claude Desktop

Download Claude Desktop for Windows
Run the installer and follow the prompts
Launch Claude and sign in with your account

Step 2 Download the Grinfi MCP Server

Option A: Download ZIP (easiest)

Go to github.com/alex-rise/grinfi-mcp-server
Click the green "Code" button → "Download ZIP"
Right-click the downloaded file → "Extract All..."
Move the extracted folder to a permanent location, for example Documents. Don’t leave it in Downloads.

Option B: Clone with Git

Open PowerShell and run:

git clone https://github.com/alex-rise/grinfi-mcp-server.git

Step 3 Run the Installer

The installer does everything for you: installs Node.js (if needed), builds the server, and configures Claude Desktop automatically.

How to run it:

Open the grinfi-mcp-server folder in File Explorer
Double-click install.bat
If Windows shows a security warning ("Windows protected your PC"), click "More info" then "Run anyway"
The installer will ask: "Do you use multiple Grinfi teams?"
- N (default) — single team. Paste your API key and press Enter.
  Get it from Grinfi → Settings → API Keys
- Y — multiple teams. Enter each team in format teamId:apiKey and press Enter. Press Enter on an empty line when done.
  Team ID: Grinfi → Settings → Team | API Key: Grinfi → Settings → API Keys

Get your API key from Grinfi → Settings → API Keys

Alternative method: If double-click doesn’t work, open PowerShell manually (press Win + X, choose "PowerShell"), then type:

cd "$HOME\Documents\grinfi-mcp-server"
powershell -ExecutionPolicy Bypass -File install.ps1

Adjust the path if you put the folder somewhere else.

Step 4 Start Using

Quit Claude Desktop completely (right-click the taskbar icon → Close window)
Reopen Claude Desktop
Look for the hammer icon at the bottom of the chat — you should see "grinfi" in the tools list
Start chatting! Try: "Show me all my Grinfi contacts"

Help Troubleshooting

"GRINFI_API_KEY is not set" — Re-run the installer or manually add your API key to the Claude Desktop config file. See the manual setup guide.

Tools not showing in Claude — Make sure Claude Desktop is fully restarted (quit and reopen, not just close window). Check that the path to the server in your config is an absolute path.

API errors (401/403) — Your API key may be invalid or expired. Generate a new one in Grinfi → Settings → API Keys.

Installer won’t start (Mac) — If double-click doesn’t work, open Terminal and run: bash /path/to/grinfi-mcp-server/install.sh

Installer won’t start (Windows) — Make sure you’re double-clicking install.bat (not install.ps1). If Windows blocks it, click "More info" → "Run anyway". If that doesn’t work, open PowerShell manually and run powershell -ExecutionPolicy Bypass -File install.ps1

What Can You Do?

Over 100 tools at your fingertips, all accessible through natural language.

👥

Contact Management

Search, create, update, and enrich contacts. Filter by any field, manage custom fields, track pipeline stages, organize into lists, handle blacklists, and manage attachments.

💬

LinkedIn Outreach

Send messages and connection requests, check unread conversations, read full conversation history, and manage replies — all from Claude.

✉️

Email Campaigns

Send emails, manage mailboxes and sender profiles, track threads, view email bodies, and set up custom tracking domains.

⚙️

Automation Sequences

Start, stop, clone, and manage multi-step outreach sequences. Add or remove contacts from automations, schedule tasks, and track metrics.

📊

Pipeline & Tasks

Move leads through pipeline stages, create follow-up tasks, schedule LinkedIn messages, and manage your entire sales workflow.

🤖

AI Templates & Variables

Create and render AI message templates, manage AI agents and variables, generate personalized content with LLM integrations.

🏢

Company Intelligence

Manage companies, look up by LinkedIn or domain, enrich company data, track employees, and organize with tags and custom fields.

🔗

Webhooks & Integrations

Create webhooks for real-time events and connect Grinfi with your existing tool stack via API.

Bridge Your CRM with Grinfi

Connect both your CRM and Grinfi to Claude via MCP, and Claude becomes the bridge between them. Push leads from your CRM into Grinfi outreach sequences, or sync Grinfi contacts back to your CRM — all through natural language commands.

Your CRM

↔

Claude AI

↔

Grinfi

CRM → Grinfi: “Take all new leads from my HubSpot list and add them to my LinkedIn outreach automation in Grinfi”
Grinfi → CRM: “Export all contacts who replied positively in Grinfi to my Salesforce pipeline”
Bi-directional sync: “When someone replies in Grinfi, update their status in my CRM and create a follow-up task”

Example Conversations

Just tell Claude what you need. Here are some things you can say:

Show me all unread LinkedIn messages and classify them by interest level

Claude fetches unread conversations, reads full history, and categorizes each lead as hot, warm, or cold.

Find contacts at Google who were created this month and add them to my CMO Germany automation

Claude searches contacts with filters, finds the automation, and adds each matching contact.

Send a follow-up LinkedIn message to Anna Schmidt saying we have a new case study for her industry

Claude finds the contact, checks previous messages to avoid repetition, and sends the message after your approval.

Stop all automations for leads who replied negatively and move them to the “Not Interested” pipeline stage

Claude processes each lead: cancels automations, updates pipeline, and marks conversations as read.

Where to Find Your API Key

Go to Settings in the left sidebar

Navigate to the API Keys tab

Click "Create API Key", give it a name, and copy the generated key