io.github.benkaiser/mob-demo MCP Server

This MCP server provides an ephemeral, no-signup demo of Mob, an AI-first personal CRM used to capture relationship information via natural language and convert it into structured relationship memory through MCP. The server is associated with a live web demo link and a beta signup option.

🛠️ Key Features

Ephemeral demo with no signup required
Natural-language input for “what happened,” “who matters,” and “what you want to remember”
Outputs structured relationship memory through MCP
Tool set: 42 tools

🚀 Use Cases

Recording relationship events and context for people in your life
Capturing personal CRM notes using natural language
Testing Mob’s MCP-based memory conversion via the live demo

⚡ Developer Benefits

Accessible live demo at https://demo.mobcrm.au/app/
Defined integration surface via MCP with 42 tools

⚠️ Limitations

Demo is ephemeral and no-signup; beta signup is available separately via the provided registration link

Mob is an AI-first personal CRM for caring for the people in your life. Tell your AI assistant what happened, who matters, and what you want to remember; Mob turns natural language into structured relationship memory through MCP.

Try the live demo · Sign up free while in beta

Mob dashboard

Why Mob

Relationships are full of details: birthdays, family ties, dietary needs, last conversations, gift ideas, follow-ups, and the context that helps you show up well. Mob keeps those details organized without making you maintain another spreadsheet or click through a dashboard.

Connect your AI assistant to Mob over MCP

What Mob helps with

Build rich contact profiles from everyday conversation.
Remember relationships, notes, preferences, birthdays, reminders, gifts, debts, tasks, and shared history.
See timelines and search across everything you know about your contacts.
Connect AI assistants over MCP, use the web app when you want to browse, and automate through the public API.

Get started

Hosted Mob is free during beta with all core features enabled.

Live demo: https://demo.mobcrm.au/app/
Sign up: https://mobcrm.au/auth/register?from=web
Documentation: https://mobcrm.au/docs/

Self-hosting

Mob is open source and can be self-hosted with Node.js and SQLite. See the self-hosting guide for installation, environment variables, persistent storage, email, and deployment notes.

Open source, license, and support

Mob is available under the Functional Source License 1.1 (MIT Future License) - free to use, modify, and self-host for any non-competing purpose, and it converts to the MIT License two years after each release. For hosted beta support, account help, or feedback, email mobsupport@benkaiser.dev.

first_name	string	required	First name (required)
last_name	string	optional	Last name
nickname	string	optional	Nickname
maiden_name	string	optional	Maiden name
gender	string	optional	Gender
pronouns	string	optional	Pronouns (e.g. she/her, he/him, they/them)
avatar_url	string	optional	Avatar URL
birthday_mode	string	optional	Birthday mode: full_date (YYYY-MM-DD), month_day (month + day only), or approximate_age (birth year estimate)
birthday_date	string	optional	Full birthday date (YYYY-MM-DD), used with birthday_mode=full_date
birthday_month	number	optional	Birthday month (1-12), used with birthday_mode=month_day
birthday_day	number	optional	Birthday day (1-31), used with birthday_mode=month_day
birthday_year_approximate	number	optional	Approximate birth year, used with birthday_mode=approximate_age
status	string	optional	Contact status (default: active)
deceased_date	string	optional	Date of death (YYYY-MM-DD)
is_favorite	boolean	optional	Mark as favorite
met_at_date	string	optional	Date you met this person (YYYY-MM-DD)
met_at_location	string	optional	Where you met this person
met_through_contact_id	string	optional	Contact ID of person who introduced you
met_description	string	optional	Story of how you met
job_title	string	optional	Job title
company	string	optional	Company or organization
industry	string	optional	Industry
work_notes	string	optional	Notes about their work

contact_id	string	required	The contact ID to update
first_name	string	optional	First name
last_name	string	optional	Last name
nickname	string	optional	Nickname
maiden_name	string	optional	Maiden name
gender	string	optional	Gender
pronouns	string	optional	Pronouns
avatar_url	string	optional	Avatar URL
birthday_mode	string	optional	Birthday mode
birthday_date	string	optional	Full birthday date (YYYY-MM-DD)
birthday_month	number	optional	Birthday month (1-12)
birthday_day	number	optional	Birthday day (1-31)
birthday_year_approximate	number	optional	Approximate birth year
status	string	optional	Contact status
deceased_date	string	optional	Date of death (YYYY-MM-DD)
is_favorite	boolean	optional	Mark as favorite
met_at_date	string	optional	Date you met this person
met_at_location	string	optional	Where you met this person
met_through_contact_id	string	optional	Contact ID of person who introduced you
met_description	string	optional	How you met
job_title	string	optional	Job title
company	string	optional	Company
industry	string	optional	Industry
work_notes	string	optional	Work notes

page	number	optional	Page number (default: 1)
per_page	number	optional	Results per page (default: 20)
status	string	optional	Filter by status
is_favorite	boolean	optional	Filter by favorite
search	string	optional	Search contacts by name, company, or job title
company	string	optional	Filter by company
tag_name	string	optional	Filter by tag name
sort_by	string	optional	Sort field (default: name)
sort_order	string	optional	Sort order (default: asc)
include_deleted	boolean	optional	Include soft-deleted contacts in results (default: false)

primary_contact_id	string	required	The contact ID to keep (primary)
secondary_contact_id	string	required	The contact ID to merge into the primary (will be soft-deleted)

action	string	required	Action to perform
contact_id	string	optional	The contact ID (required for "add")
id	string	optional	The contact method ID (required for "update" and "remove")
type	string	optional	Type of contact method (required for "add"). Built-ins: email, phone, whatsapp, telegram, signal, twitter, instagram, facebook, linkedin, website, other. Custom values defined in Settings are also accepted.
value	string	optional	The value - email, phone number, handle (required for "add")
label	string	optional	Label (e.g. "Personal", "Work")
is_primary	boolean	optional	Set as primary for this type

unread_only	boolean	optional	Only show unread notifications
page	number	optional	Page number (default: 1)
per_page	number	optional	Results per page (default: 20)

id	string	optional	The notification ID (required unless all=true)
all	boolean	optional	Mark all notifications as read (default: false)

days_ahead	number	optional	Look-ahead window in days from today (default: 30). Ignored if month is provided.
month	number	optional	Optional: show all birthdays in a specific month (1-12) instead of using days_ahead

query	string	required	Search term
entity_types	array	optional	Optional: filter to specific entity types (default: all types)
limit_per_type	number	optional	Max results per entity type (default: 10)

days_since_last_interaction	number	optional	Minimum days since last activity to be included (default: 30)
status	string	optional	Contact status filter (default: active)
tag_name	string	optional	Filter to contacts with this tag (e.g., "close friends")
is_favorite	boolean	optional	Filter to favorites only
limit	number	optional	Max results to return (default: 20)

action	string	required	Action to perform
timezone	string	optional	IANA timezone (e.g. "America/New_York", "Europe/London")
birthday_reminder_offsets	array	optional	Array of day offsets for birthday reminders (e.g. [0,7,30] = day-of, 1 week before, 1 month before)
reminder_offsets	array	optional	Array of day offsets for custom reminder advance notice (e.g. [0,7,30] = day-of, 1 week before, 1 month before)
birthday_reminder_time	string	optional	Time of day for birthday reminders in HH:MM 24-hour format (e.g. "09:00")

io.github.benkaiser/mob-demo MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

contact_create

contact_get

contact_update

contact_delete

contact_restore

contact_list

contact_merge

contact_find_duplicates

contact_method_manage

address_manage

food_preferences_get

food_preferences_upsert

custom_field_manage

relationship_manage

note_manage

note_list

tag_manage

activity_manage

activity_list

activity_type_manage

life_event_manage

contact_timeline

reminder_manage

notification_list

notification_create

notification_read

gift_manage

gift_list

debt_manage

task_manage

data_export

data_statistics

prime

upcoming_birthdays

global_search

contacts_needing_attention

upcoming_reminders

batch_create_contacts

batch_tag_contacts

batch_create_activities

manage_settings

manage_push_notifications

Why Mob

What Mob helps with

Get started

Self-hosting

Open source, license, and support

Install

Remote endpoint

Related servers