Skip to main content

​
MCP Client Installation

Instructions for installing and configuring the Famulor MCP Server for various MCP-compatible clients.

​
Prerequisites

  • An MCP-compatible client such as:
    • ChatGPT Desktop App (Download)
    • Claude Desktop App (Download)
    • Cursor IDE
    • Any other MCP-compatible client
  • A Famulor API key (Get one here)
Note: If you want to run your own local server (Option 2), you also need:

​
Quick Start

The easiest way to get started! Use our hosted MCP Server at https://mcp.famulor.io.

​
1. Obtain API Key

  1. Go to Famulor API Keys
  2. Log in or create an account
  3. Create a new API key
  4. Copy the API key (you will need it in the next step)

​
2. Configure MCP in your client

See the section Client-specific Installation below for detailed instructions for your MCP client (Cursor, Claude Desktop, ChatGPT Desktop, etc.). Quick example of configuration: 
{
  "mcpServers": {
    "famulor": {
      "url": "https://mcp.famulor.io/sse",
      "env": {
        "FAMULOR_API_KEY": "your-api-key-here"
      }
    }
  }
}

​
3. Restart MCP Client

  1. Completely close your MCP client
  2. Restart it
  3. The MCP server should connect automatically

​
4. Test it out!

In your MCP client (ChatGPT, Claude, etc.), try asking:
  • “Show me my Famulor assistants”
  • “List my recent calls”
  • “Make a call with assistant [ID] to [phone number]“

​
Option 2: Use Your Own Local Server

If you want to run the server locally:

​
1. Clone the repository

git clone https://github.com/bekservice/Famulor-MCP.git
cd Famulor-MCP

​
2. Install dependencies

npm install

​
3. Build the server

npm run build

​
4. Obtain API Key

  1. Go to Famulor API Keys
  2. Log in or create an account
  3. Create a new API key
  4. Copy the API key (you will need it in the next step)

​
5. Configure MCP in your client

Create or edit the MCP configuration file for your platform and client. See the section Client-specific Installation below for detailed instructions. Example configuration: 
{
  "mcpServers": {
    "famulor": {
      "command": "node",
      "args": [
        "/absolute/path/to/Famulor-MCP/dist/index.js"
      ],
      "env": {
        "FAMULOR_API_KEY": "your-api-key-here"
      }
    }
  }
}
Important:
  • Replace /absolute/path/to/Famulor-MCP with the actual absolute path to your cloned repository
  • Replace your-api-key-here with your actual Famulor API key
  • On Windows, use forward slashes or properly escaped backslashes in the path
Example paths:
  • macOS: /Users/username/Famulor-MCP/dist/index.js
  • Windows: C:/Users/username/Famulor-MCP/dist/index.js or C:\\Users\\username\\Famulor-MCP\\dist\\index.js
  • Linux: /home/username/Famulor-MCP/dist/index.js

​
6. Restart MCP Client

  1. Completely close your MCP client (ChatGPT Desktop, Claude Desktop, etc.)
  2. Restart it
  3. The MCP server should connect automatically

​
7. Test it out!

In your MCP client (ChatGPT, Claude, etc.), try asking:
  • “Show me my Famulor assistants”
  • “List my recent calls”
  • “Make a call with assistant [ID] to [phone number]“

​
Client-specific Installation

Choose your MCP client below for specific installation instructions:

​
For Claude Desktop

Important: Claude Desktop currently only supports local command-based MCP server configurations. HTTP/URL-based configurations are not supported, even in the latest version.

​
Setup Instructions

  1. Find the configuration file:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  2. Add MCP server configuration: Open the configuration file and add the following under the mcpServers section: 
    {
  "mcpServers": {
    "famulor": {
      "command": "node",
      "args": [
        "/absolute/path/to/Famulor-MCP/dist/index.js"
      ],
      "env": {
        "FAMULOR_API_KEY": "your-api-key-here"
      }
    }
  }
}
    Important:
    • Replace /absolute/path/to/Famulor-MCP with your actual absolute path to the repository
    • Replace your-api-key-here with your actual Famulor API key
    • You can get your API key at Famulor API Keys
    • Make sure you have built the server: npm run build
    • The path must be absolute (not relative)
  3. Fully restart Claude Desktop to apply changes.

​
For Cursor

Global installation (Recommended):
  1. Go to Cursor Settings > Tools & Integrations
  2. Click on “New MCP Server”
  3. This opens ~/.cursor/mcp.json
  4. Add the following configuration: 
    {
  "mcpServers": {
    "famulor": {
      "type": "http",
      "url": "https://mcp.famulor.io/sse",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}
    Important:
    • Replace your-api-key-here with your actual Famulor API key
    • The API key must be included with Bearer in the Authorization header
    • You can get your API key at Famulor API Keys
  5. Go back to Settings > MCP and click the Refresh button
  6. The Cursor agent can now use the Famulor MCP tools
Project-specific installation:
  1. Create or edit .cursor/mcp.json in your project root directory
  2. Add the same configuration as above
  3. Restart Cursor or refresh the MCP settings

​
Option 2: Use Your Own Local Server

Global installation (Recommended):
  1. Go to Cursor Settings > Tools & Integrations
  2. Click on “New MCP Server”
  3. This opens ~/.cursor/mcp.json
  4. Add the following configuration: 
    {
  "mcpServers": {
    "famulor": {
      "command": "node",
      "args": [
        "/absolute/path/to/Famulor-MCP/dist/index.js"
      ],
      "env": {
        "FAMULOR_API_KEY": "your-api-key-here"
      }
    }
  }
}
  5. Go back to Settings > MCP and click the Refresh button
  6. The Cursor agent can now use the Famulor MCP tools
Project-specific installation:
  1. Create or edit .cursor/mcp.json in your project root directory
  2. Add the same configuration as above
  3. Restart Cursor or refresh the MCP settings

​
For Claude Code

To add the online MCP server to Claude Code, run this command in your terminal: 
claude mcp add-json "famulor" '{"type":"http","url":"https://mcp.famulor.io/sse","headers":{"Authorization":"Bearer your-api-key-here"}}'
Note:
  • Replace your-api-key-here with your actual Famulor API key
  • The API key must be included with Bearer in the Authorization header
  • You can get your API key at Famulor API Keys

​
Option 2: Use Your Own Local Server

To add your local MCP server to Claude Code, run this command in your terminal: 
claude mcp add-json "famulor" '{"command":"node","args":["/absolute/path/to/Famulor-MCP/dist/index.js"],"env":{"FAMULOR_API_KEY":"your-api-key-here"}}'
Note: Replace /absolute/path/to/Famulor-MCP/dist/index.js with your actual path and your-api-key-here with your actual API key. See the official Claude Code MCP documentation for more details.

​
For ChatGPT Desktop App

  1. Find the configuration file:
    • macOS: ~/Library/Application Support/ChatGPT/mcp.json
    • Windows: %APPDATA%\ChatGPT\mcp.json or C:\Users\YourUsername\AppData\Roaming\ChatGPT\mcp.json
    • Linux: ~/.config/ChatGPT/mcp.json
  2. Add the online MCP server configuration: 
    {
  "mcpServers": {
    "famulor": {
      "url": "https://mcp.famulor.io/sse",
      "env": {
        "FAMULOR_API_KEY": "your-api-key-here"
      }
    }
  }
}
  3. Restart ChatGPT Desktop App for changes to take effect.

​
Option 2: Use Your Own Local Server

  1. Find the configuration file:
    • macOS: ~/Library/Application Support/ChatGPT/mcp.json
    • Windows: %APPDATA%\ChatGPT\mcp.json or C:\Users\YourUsername\AppData\Roaming\ChatGPT\mcp.json
    • Linux: ~/.config/ChatGPT/mcp.json
  2. Add the MCP server configuration: 
    {
  "mcpServers": {
    "famulor": {
      "command": "node",
      "args": [
        "/absolute/path/to/Famulor-MCP/dist/index.js"
      ],
      "env": {
        "FAMULOR_API_KEY": "your-api-key-here"
      }
    }
  }
}
  3. Restart ChatGPT Desktop App for changes to take effect.

​
Alternative: Use Environment Variable

Instead of placing the API key in mcp.json, you can use an environment variable:
  1. Set the environment variable: 
    export FAMULOR_API_KEY="your-api-key-here"  # macOS/Linux
# or
set FAMULOR_API_KEY=your-api-key-here        # Windows CMD
# or
$env:FAMULOR_API_KEY="your-api-key-here"     # Windows PowerShell
  2. Remove the env section from mcp.json: 
    {
  "mcpServers": {
    "famulor": {
      "command": "node",
      "args": [
        "/absolute/path/to/Famulor-MCP/dist/index.js"
      ]
    }
  }
}

​
Troubleshooting

​
Server Not Found

  • Verify that the build was successful: npm run build
  • Check that dist/index.js exists
  • Ensure the path in mcp.json is correct and absolute
  • On Windows, ensure you use forward slashes or properly escaped backslashes

​
API Key Errors

  • Make sure the API key is set in mcp.json or as an environment variable
  • Check that the API key is valid under Famulor API Keys
  • Confirm that the API key is not expired

​
MCP Server Not Detected

  • Validate the JSON syntax in your MCP configuration file (use a JSON validator)
  • Confirm the path to dist/index.js is absolute
  • Fully restart your MCP client (ChatGPT Desktop, Claude Desktop, etc.)
  • Check your client logs for error messages

​
Node.js Version Issues

  • Check your Node.js version: node --version (must be >= 20.0.0)
  • Update Node.js if needed: Download Node.js