🦘 Mob — AI-First Personal CRM

Mob is a personal CRM you interact with entirely through natural language. Built as an MCP server, there are no forms, no dashboards, no buttons — just talk about your relationships and Mob keeps track.

"Mob" is the name for a group of kangaroos.

What It Does

Mob helps you maintain meaningful relationships by remembering everything about the people in your life:

• Contacts — Store names, birthdays, addresses, work info, food preferences, and more

• Relationships — Map how people are connected (family, friends, colleagues, partners)

• Activities — Log phone calls, coffee dates, dinners, and shared experiences

• Life Events — Record milestones like graduations, weddings, new jobs, and moves

• Reminders — Never forget a birthday, follow-up, or check-in

• Notes — Pin important things to remember about someone

• Gifts & Debts — Track gift ideas and money owed

• Tags — Organize contacts with flexible labels

Related MCP server: Motion MCP Server

Hosted Beta

Hosted Mob is free during beta with all features enabled and no contact caps. For support, email mobsupport@benkaiser.dev.

How It Works

Mob is an MCP server. You connect to it with an MCP-compatible AI client, and interact using natural language:

You: "Add a new contact: Sarah Chen, she works at Google as a senior engineer"
You: "Log that I had coffee with Mike yesterday at Blue Bottle"
You: "When is Tom's birthday?"
You: "Remind me to call Lisa next Tuesday"
You: "Who haven't I talked to in a while?"

The AI assistant interprets your intent and calls the appropriate MCP tools behind the scenes.

Connecting

MCP Connection Details

Recommended Client

We recommend Joey MCP Client for connecting to Mob.

Connecting with other MCP clients

Any MCP-compatible client that supports Streamable HTTP transport and OAuth can connect. Configure your client with the server URL above and it will be guided through the OAuth flow.

Operating Modes

Persistent Mode (Default)

Full-featured mode with user accounts. Create an account with your name, email, and password. Your data is stored permanently in a local SQLite database.

mob-crm start

Forgetful Mode

Ephemeral mode for demos or privacy-sensitive use. No login required — data exists only for the session and is automatically destroyed on disconnect or after 2 hours.

mob-crm start --forgetful

Development

Prerequisites

• Node.js 20+

• npm

Getting Started

# Install dependencies
npm install

# Run in development mode (auto-reload)
npm run dev

# Run tests
npm test

# Build for production
npm run build

# Start production server
npm start

Deployment

Mob stores its data in a SQLite database. For deployment, configure the MOB_DATA_DIR environment variable to point to a persistent storage directory:

# Set the data directory for SQLite storage
export MOB_DATA_DIR=/var/data/mob-crm

# Start the server
npm start

The server will create and manage its SQLite database files in the specified directory. Ensure this directory is on persistent storage (not an ephemeral filesystem) to retain data across restarts.

For a hosted beta deployment, also set MOB_HOSTED=true and MOB_BASE_URL to the public HTTPS origin so cookies and OAuth metadata are generated correctly.

Email (SMTP)

Password reset and email verification send transactional email via SMTP (any provider, including self-hosted). Email is optional — if SMTP is not configured, these flows degrade gracefully (the server logs a warning and skips sending). Configure it with:

export SMTP_HOST=smtp.example.com        # enables email when set
export SMTP_PORT=587                      # default 587
export SMTP_SECURE=false                  # true for implicit TLS (port 465)
export SMTP_USER=apikey                   # optional
export SMTP_PASS=secret                   # optional
export MAIL_FROM="Mob <no-reply@example.com>"

Hosted Beta Operations

Hosted beta accounts are free, uncapped, and include all features. Before running a hosted beta instance:

• Set MOB_HOSTED=true, MOB_BASE_URL=https://<public-origin>, and MOB_DATA_DIR on persistent storage.

• Put the server behind TLS and ensure the public base URL is HTTPS so session and CSRF cookies are marked secure.

• Back up the SQLite data directory regularly and verify restore procedures.

• Keep outbound webhook egress restricted; Mob also blocks non-HTTPS, localhost, private, link-local, and reserved webhook targets in application code.

• Configure SMTP (SMTP_HOST, MAIL_FROM, etc.) so password reset and email verification links can be delivered.

• Users manage their own account from Settings: change password, edit profile (name/email/timezone), verify email, review connected AI assistants and active sessions, export their data, and delete their account. Direct other account help or data-deletion questions to mobsupport@benkaiser.dev.

Project Structure

mob-mcp-crm/
├── docs/
│   └── FEATURES.md          # Full feature specification
├── src/
│   ├── server/               # MCP server setup, Streamable HTTP transport
│   ├── auth/                 # OAuth PKCE flow, account management
│   ├── db/                   # SQLite schema, migrations, queries
│   ├── services/             # Business logic per entity
│   ├── tools/                # MCP tool definitions and handlers
│   └── notifications/        # Notification generation and delivery
├── tests/
│   ├── unit/                 # Pure function tests
│   ├── integration/          # Service + database tests
│   └── e2e/                  # MCP protocol tests
└── public/
    └── index.html            # Homepage / landing page

Documentation

• Feature Specification — Comprehensive specification covering all entities, MCP tools, auth, elicitation, and testing strategy

License

MIT