Famulor

Famulor MCP

Connect Claude, Codex, Cursor, VS Code, and other MCP clients to the complete tenant-safe Famulor platform API.

MCP endpoint · API & MCP settings · Docs

Setup

Add the server in your client, then sign in to Famulor and approve the requested workspace permissions in the browser. Claude and ChatGPT use OAuth; there is no API key to paste into their connector settings.

Server URL: https://app.famulor.io/mcp. It runs inside the Famulor platform, so there is nothing to install or host. Your plan needs the Connect AI / MCP feature; without it the endpoint answers 403.

Claude Code

claude mcp add --transport http famulor https://app.famulor.io/mcp

Add the server first, then complete the browser-based OAuth flow.

Claude Desktop

Settings > Connectors > Add custom connector

https://app.famulor.io/mcp

Copy the URL, paste it into the connector dialog, and sign in when prompted.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "famulor": {
      "type": "http",
      "url": "https://app.famulor.io/mcp"
    }
  }
}

Add the server first, then complete the browser-based OAuth flow.

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "famulor": {
      "serverUrl": "https://app.famulor.io/mcp"
    }
  }
}

Add the server first, then complete the browser-based OAuth flow.

VS Code

.vscode/mcp.json

{
  "servers": {
    "famulor": {
      "type": "http",
      "url": "https://app.famulor.io/mcp"
    }
  }
}

Add the server first, then complete the browser-based OAuth flow.

Cline

Cline extension > MCP Servers > Configure

{
  "mcpServers": {
    "famulor": {
      "url": "https://app.famulor.io/mcp"
    }
  }
}

Add the server first, then complete the browser-based OAuth flow.

Continue

~/.continue/config.yaml

mcpServers:
  - name: famulor
    type: streamable-http
    url: "https://app.famulor.io/mcp"

Add the server first, then complete the browser-based OAuth flow.

OpenClaw

openclaw mcp add famulor --url https://app.famulor.io/mcp --transport streamable-http --auth oauth
openclaw mcp login famulor

Or in ~/.openclaw/openclaw.json:

{
  "mcp": {
    "servers": {
      "famulor": {
        "url": "https://app.famulor.io/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

Tip: there is also a ready-made Famulor skill — openclaw skills install famulor-skill.

Hermes Agent

hermes mcp add famulor --url https://app.famulor.io/mcp
hermes mcp login famulor

Or in ~/.hermes/config.yaml:

mcp_servers:
  famulor:
    url: "https://app.famulor.io/mcp"
    auth: oauth

Apply in-session with /reload-mcp.

Zed

~/.config/zed/settings.json

{
  "context_servers": {
    "famulor": {
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://app.famulor.io/mcp"
      ],
      "command": "npx"
    }
  }
}

Add the server first, then complete the browser-based OAuth flow.

What you can do

Once connected, your AI assistant discovers the current public tool catalog directly from Famulor. The catalog covers, among other areas:

Assistants — create, update, delete AI voice agents · list voices, languages, LLM/multimodal models, TTS/STT providers · toggle inbound and conversation-ended webhooks

History & calls — inspect cross-channel history and transcripts · make and manage calls

Campaigns — create campaigns, manage retry rules and allowed-hours windows · start, stop and delete

Audience — manage contacts, tags, segments, suppression and campaign membership

Knowledge bases — create knowledge bases · upload website-scraped documents · update / delete

Telephony — phone numbers, number verification, assignments and SIP trunks

Messaging & email — WhatsApp, Instagram, Messenger, Telegram, Slack, Teams, Discord, Google Chat, X, helpdesk and email conversation workflows

WhatsApp — list senders and templates · check 24h session window · send template or freeform messages

Automations & operations — flows, routines, dashboards, integrations, webhooks, booking, workspace settings and account administration

Ask the assistant in plain English, e.g. "Create a German sales assistant using GPT-4.1-mini and the Susi voice", "Start campaign #42 and add these 50 leads", "Show me all calls today where the goal wasn't reached."

How auth works

The endpoint implements MCP OAuth discovery, authorization code with PKCE, dynamic client registration and Client ID Metadata Documents. Your MCP client opens Famulor in a browser, where you sign in on app.famulor.io, choose a workspace and approve the requested permissions.

Server-to-server clients can send an API key instead: create one under Settings > API & MCP on app.famulor.io and pass it as Authorization: Bearer fam_…. Claude and ChatGPT connectors always use OAuth.

Full tool catalog and scopes: docs.famulor.io/mcp/tools-and-scopes

Famulor 1.0 (app.famulor.de)

This MCP server works with workspaces on the Famulor platform at app.famulor.io. Famulor 1.0 (app.famulor.de) stays available; to bring assistants, tools, knowledge, campaigns, automations and your own telephony over, use Migrate from Famulor 1.0.

What is in this repository

The server itself runs inside the Famulor platform. This repository holds what clients and directories need to find it:

The earlier self-hosted server and its npm package famulor-mcp are retired.

License

MIT