people-context — Claude Code MCP server for people context
This server keeps information about people in a local database and lets an agent look it up. Use it to retain relationship details, past agreements, and communication preferences.
claude mcp add people-context -- uvx people-contextWhat people-context does
people-context stores relationships, roles, durable facts, brief interaction notes, reminders, and a timeline for each person in a local SQLite file. Its lookup tools can search names, aliases, and handles. When a name matches multiple people, the server returns separate candidates and explains the matches rather than silently picking one.
Imports from email, calendars, vCards, and other exports wait for your review before anything is saved. The original source content is discarded; writes are audited, and the delete operation removes records. Sensitive entries require operator access. Ordinary commands do not make network requests.
You need Python 3.11+ and uv. Add the server to Claude Code with claude mcp add people-context -- uvx people-context. Its database stays on your machine, so the agent can only use the details you choose to record.
What it helps with
- disambiguate people who share a name
- retrieve the latest agreement with a contact
- record someone’s communication preferences
- find contacts with stale relationships
- review exported contact data before importing
Example prompts for the agent
- Who is Priya, and what did we agree on last time?
- Remember that Daniel prefers short emails.
- Which of my contacts have I not spoken with recently?
How to install people-context
Platform CLI
claude mcp add people-context -- uvx people-contextuvx runs the command named after the package; if the README names another one, use uvx --from people-context <command>
Platform CLI
codex mcp add people-context -- uvx people-contextuvx runs the command named after the package; if the README names another one, use uvx --from people-context <command>
Config file
{
"mcpServers": {
"people-context": {
"command": "uvx",
"args": [
"people-context"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from people-context <command>
Config file
{
"servers": {
"people-context": {
"type": "stdio",
"command": "uvx",
"args": [
"people-context"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from people-context <command>
Platform CLI
gemini mcp add people-context uvx people-contextuvx runs the command named after the package; if the README names another one, use uvx --from people-context <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about people-context
How do I install people-context in Claude Code?
Run claude mcp add people-context -- uvx people-context. Python 3.11+ and uv are required.
What does people-context do?
It keeps local records about people and gives an agent tools to look up names, relationships, agreements, reminders, and interaction history.
How does people-context handle email and calendar exports?
Imported material is presented for review first. You choose which candidate details to save, and the original content is not retained.
