Follow Up Boss MCP

A dedicated Model Context Protocol server that connects Claude / Cowork directly to your Follow Up Boss account through the official FUB REST API — no Zapier in the middle, no monthly task credits to run out.

Built for the Morning Command Center dashboard, but usable by any Claude conversation.

What it can do

Related MCP server: GHL MCP Server

1. Get your Follow Up Boss API key

In Follow Up Boss: Admin → API → Create API Key. Copy it somewhere safe — you'll paste it into the config below. (Auth is your key as the username with a blank password; the server handles that for you.)

2. Install

You need Node.js 18+. Then, in this folder:

npm install

Quick sanity check (no key needed):

npm test          # runs the offline test suite (17 checks)
node server.js --self-test   # lists the 14 tools

3. Connect it to Claude Desktop / Cowork

Open your Claude desktop config file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add a follow-up-boss entry under mcpServers (keep any servers already there):

{
  "mcpServers": {
    "follow-up-boss": {
      "command": "node",
      "args": ["C:\\Users\\homes\\Claude\\Projects\\tucker\\follow-up-boss-mcp\\server.js"],
      "env": {
        "FUB_API_KEY": "paste-your-key-here",
        "FUB_SYSTEM": "",
        "FUB_SYSTEM_KEY": ""
      }
    }
  }
}

The args path above already points at where this server lives on your machine. On macOS use forward slashes.

Then fully quit and reopen Claude Desktop. You'll know it worked when Claude can call fub_test_connection and returns your account.

4. First things to try

• "Use follow-up-boss to test the connection."

• "Show me my stale leads with no activity in 45 days."

• "List my open tasks that are overdue."

• "Schedule a follow-up task to text lead #123 tomorrow at 10am."

Notes

• Rate limits: FUB allows ~250 requests per 10s window for registered systems (125 without X-System headers). The dashboard makes only a handful per load, so you're well within limits.

• Security: your API key stays local — it lives in your Claude config / environment and is sent only to api.followupboss.com over HTTPS. Don't commit a filled-in .env to git.

• The dashboard: once this server is connected, the Morning Command Center can be re-pointed from the Zapier path to these tools. That rewire is quick — just say the word and I'll update the artifact to call follow-up-boss directly.

Files

• server.js — MCP wiring (stdio transport)

• fub.js — FUB API layer + tool definitions (SDK-free, unit-tested)

• test.mjs — offline test suite (mocks the API)

• .env.example — template for credentials