People Context MCP server

people-context

<!-- mcp-name: io.github.JinyangWang27/people-context -->

English | 简体中文

Your agent already remembers your codebase. Now it can remember your people.

people-context is a local-first MCP server and CLI that gives AI agents durable memory about the people in your life: who someone is, how you know them, what you last agreed, and how they like to be talked to. One SQLite file on your machine. No account, no cloud, no network calls.

Why

Ask an assistant "how should I approach Priya about the reporting delay?" and it has nothing: it does not know which Priya, that she is your counterpart at a partner org, that you agreed a new deadline last week, or that she prefers a short email over a call. That knowledge lives in your head, your inbox, and a notes file the agent cannot see.

people-context keeps it in one place the agent can query through narrow tools:

as two candidates with a match reason, never a silent guess.

• Who is this? Explainable name resolution over names, nicknames, aliases, and handles. Two Priyas come back

traits, reminders, and a per-person timeline, each disclosed only as far as the request needs.

• What do I know? Relationships, organisations and roles, durable facts, concise interaction summaries,

and your own written philosophy.

• How do I talk to them? Communication guidance grounded in recorded traits, past friction, open follow-ups,

reviewable candidates. You approve what gets recorded; raw source content is never kept.

• Who has gone quiet? Stale-relationship and upcoming-date reports over what is already stored.
• Get data in safely. Email, mbox, vCard, calendar, LinkedIn, Outlook, and WhatsApp exports are staged as

It is opinionated about trust: writes are audited, forget is a real delete, sensitive records sit behind an operator-only gate that a prompt cannot open, and ordinary commands never touch the network.

Demo

A packaged fictional dataset is the fastest way to see identity resolution, graph traversal, and bounded context without touching real data:

uvx --from people-context pctx demo --reset

The demo always writes its own dedicated database at {XDGDATAHOME or ~/.local/share}/people-context/demo.db. It ignores --db, PEOPLECONTEXTDB, the config file, and workspace discovery, and --reset replaces only that file plus its -wal/-shm companions, so a real database is never read or modified. Seeding writes audited fictional people, handles, affiliations, facts, interactions, and a connected relationship graph, then prints the path-targeted server command and concrete tool calls that use the ids it just created:

Shortened. The full README is on GitHub.