home / mcp / mob mcp server

Mob MCP Server

Provides an AI-first personal CRM with MCP-based access to contacts, relationships, activities, life events, reminders, notes, gifts, debts, and tags.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "benkaiser-mob-mcp-crm": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "MOB_DATA_DIR": "/var/data/mob-crm"
      }
    }
  }
}

Mob is an AI-first personal CRM that you interact with entirely through natural language. It remembers and organizes your relationships so you can discuss people and events freely while Mob handles the data behind the scenes, helping you stay connected with purpose and ease.

How to use

Connect to Mob with an MCP-compatible AI client and start talking about your contacts, relationships, and memories. You can add people, log meetings, set reminders, note life events, track gifts or debts, and tag relationships. The AI interprets what you say and stores it in its database, so you can ask questions like who you haven’t spoken to recently or when a birthday is coming up.

How to install

Prerequisites you need before installing Mob:
- Node.js 20+ installed on your system
- npm available for package management
- A persistent storage location for data (SQLite database files) if you plan to run in persistent mode.

Additional setup and usage notes

Mob stores its data in a SQLite database. For persistent deployments, point the data directory to a stable filesystem path so data survives restarts.

Configuration and running modes

Mob supports a persistent mode with user accounts and an ephemeral forgetful mode suitable for demos. In forgetful mode, no login is required and data is discarded after the session ends or after a timeout.

mob-crm start
```
Start Mob in persistent mode with a local SQLite database.

Security and deployment notes

When deploying Mob, set MOB_DATA_DIR to a persistent storage directory to ensure the SQLite database files are preserved across restarts. The server will manage its database within the specified directory.

Tools and endpoints

Mob exposes a collection of capabilities that you can use through MCP tools. These tools cover creating and updating contacts, logging activities, recording life events, managing reminders, and organizing notes, gifts, debts, and tags.

Example interactions

You can pose natural language questions and commands such as:

Deployment example snippets

{
  "type": "http",
  "name": "mob_http_mcp",
  "url": "http://localhost:3000/mcp",
  "args": []
}
```
This config connects to Mob’s MCP server over Streamable HTTP at the shown URL.

Available tools

add_contact

Create a new contact with associated details such as name, job, and preferences.

log_activity

Record a meeting, phone call, or other interaction with a contact.

record_life_event

Save milestones like graduations, moves, new jobs, or weddings.

set_reminder

Create reminders for follow-ups, birthdays, or check-ins.

notes

Attach notes to a contact to remember important details.

gifts_and_debts

Track gift ideas and money owed across contacts.