# 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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 59
- Author: JinyangWang27
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/JinyangWang27/people-context
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/people-context

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add people-context -- uvx people-context
```
uvx runs the command named after the package; if the README names another one, use uvx --from people-context <command>

### Codex

**Platform CLI**
```bash
codex mcp add people-context -- uvx people-context
```
uvx runs the command named after the package; if the README names another one, use uvx --from people-context <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add people-context uvx people-context
```
uvx runs the command named after the package; if the README names another one, use uvx --from people-context <command>

## When to use it
- 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
- 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?

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md