# People Context

> People Context is a free MCP server for knowledge and memory. Local-first memory of the people in your life for AI agents, stored in one SQLite file. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/jinyangwang27/people-context
- **MCP Registry name:** io.github.JinyangWang27/people-context
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

People-context answers the questions an assistant cannot: which Priya, how you know her, what you last agreed, and whether she prefers email to calls. Everything lives in one SQLite file on your machine, with no account, no cloud and no network calls from ordinary commands.

Name resolution is explainable. Names, nicknames, aliases and handles are matched, and two people called Priya come back as two candidates with a match reason rather than a silent guess. Beyond lookup it records relationships, organisations and roles, facts, interaction summaries, traits and reminders, and it reports who has gone quiet and which dates are coming up.

Imports from email, mbox, vCard, calendar, LinkedIn, Outlook and WhatsApp exports are staged as candidates you approve, and raw source content is not kept. Writes are audited, `forget` is a real delete, and sensitive records sit behind an operator-only gate. A `pctx browse` command opens a local review page, and a packaged fictional demo database lets you try it safely.

## Features

- **Explainable name resolution:** Ambiguous names return candidates with a match reason, never a guess.
- **Relationship graph:** Walk connections between people, organisations and roles.
- **Staged imports:** Email, vCard, calendar, LinkedIn, Outlook and WhatsApp data arrive as candidates you approve.
- **Audited writes:** Changes are logged, and forget performs a real deletion.
- **Local browser review:** pctx browse opens a page for editing people, facts and reminders.
- **Stale-contact reports:** Surfaces people you have not spoken to and upcoming dates.

## Good for

- Brief yourself before a meeting with someone you rarely see
- Record that a contact prefers short emails
- Find out who you have not spoken to in a while
- Trace how two people in your network are connected
- Import a vCard and review it before saving

## Install

### Claude Code (Terminal)

```sh
claude mcp add people-context -- uvx people-context
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "people-context": {
      "command": "uvx",
      "args": [
        "people-context"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "people-context": {
      "command": "uvx",
      "args": [
        "people-context"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "people-context": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "people-context"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "people-context": {
      "command": "uvx",
      "args": [
        "people-context"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "people-context": {
      "command": "uvx",
      "args": [
        "people-context"
      ]
    }
  }
}
```

## Tools

- `resolve_person`: Finds a person by name, alias or handle and returns candidates with match reasons.
- `remember`: Records a fact about a person, creating them only if nobody matches.
- `get_relationship_graph`: Returns the relationships around a person to a chosen depth.
- `find_connection`: Finds how two people are connected.

## FAQ

### Does it send data to the cloud?

No. It is local-first, with one SQLite file, no account and no network calls from ordinary commands.

### Which clients does it support?

Claude Code, Claude Desktop, Codex, Cursor, Windsurf, VS Code, OpenClaw or any MCP client.

### How do I try it safely?

Run uvx --from people-context pctx demo --reset to use a fictional demo database.

### Can I really delete a person's data?

Yes, forget is a real delete, according to the README.

### Is People Context free?

Yes. People Context is free to use.

### How do I add People Context to Claude Code?

Run this command in your terminal: claude mcp add people-context -- uvx people-context

### What are the best alternatives to People Context?

The closest alternatives to People Context are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and NeuroStack.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Digitalnz](https://ai-powered.com/mcp/digitalnz): Digitalnz is a freemium MCP server for knowledge and memory.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/people-context
