---
title: Connections and portability
description: Which sources PersonaKit reads, how assistants connect over MCP, and what is planned.
status: pre-release
audience: people who run PersonaKit locally, contributors, and AI assistants
last_verified: 2026-11-12
---

# Connections

## Sources

| Source | Status |
|---|---|
| Claude Code sessions | Available |
| Codex sessions | Available |
| ChatGPT, claude.ai, Gemini exports | Planned (0.3) |
| Other assistants | Not available |

Select with `personakit sweep --source claude-code`, `--source codex-cli`, or `all` (the default).

## Extraction

`--cli claude` or `--cli codex` runs extraction through your own signed-in CLI. You name the
model with `--model`. Extraction runs in an empty temporary directory with tools disabled.

## Assistants over MCP

`personakit serve` starts an MCP server over stdio with two tools:

- `personakit_read(question, limit)`: see [reference](reference/personakit-read.md).
- `personakit_propose(text, quote, category)`: suggest a memory; it is stored `unconfirmed`.

**Claude Code**

```sh
claude mcp add personakit -- personakit serve
```

**Codex** (`~/.codex/config.toml`)

```toml
[mcp_servers.personakit]
command = "personakit"
args = ["serve"]
```

Any MCP client that can launch a stdio command can use it. There is no remote or hosted connector.

## Portability

Your data is one SQLite file (`~/.personakit/store.db`, or set `--db` / `PERSONAKIT_DB`).
A dedicated export command is Not available in 0.1.