# Particles

> Particles is an open-source MCP server for knowledge and memory. Append-only ledger of sourced, dated, confidence-scored claims that agents cite. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API, Linux, macOS, Windows
- **Website:** https://docs.linkedparticles.org/cli/
- **Repository:** https://github.com/linkedparticles/particles-engine-py
- **MCP Registry name:** org.linkedparticles/particles
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

Each record, a particle, is one claim plus what is needed to judge it: who said it, where, when and how confident they were. Particles are never edited or deleted; they are superseded, retracted or disputed in the open, and how much to trust one is decided at query time. Because nothing is overwritten, you can ask what the store believed at a past date and why it stopped, using an `--as-of` lens, and every answer cites the beliefs behind it.

The MCP server is the read-only surface over the Python engine. Store-reading accessors work without a model key, while `query` composes a cited answer and the semantic half of `lint` reasons over claim pairs, and both need an Anthropic key. Write tools are switched on only for stores named in the `mcp.write.enabled_stores` allowlist. The README says any OpenAI-compatible endpoint, hosted or local, also works for extraction and answers.

A single command, `particles init claude-code`, adds session-start and session-end hooks for Claude Code memory. The engine is Apache-2.0 and installs with `pip install linkedparticles` on Python 3.11 or newer.

## Features

- **Append-only claims:** Claims are superseded or disputed in the open, never overwritten.
- **Cited answers:** Query answers cite the particles they were built from.
- **As-of history:** Ask what the store believed on a past date and why it changed.
- **Store health checks:** Lint finds contradictions, staleness and orphaned links.
- **Claude Code memory:** One command installs session digest and harvest hooks.
- **Write allowlist:** Write tools stay off unless a store is explicitly enabled.

## Good for

- Give a coding agent a durable, auditable memory
- Trace a wrong agent answer back to its source claim
- Ask what a knowledge base believed a year ago
- Export beliefs to Obsidian, Anki, Logseq or Notion
- Find contradictions across ingested documents

## Install

### Claude Code (Terminal)

```sh
claude mcp add particles --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- uvx linkedparticles
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "particles": {
      "command": "uvx",
      "args": [
        "linkedparticles"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "particles": {
      "command": "uvx",
      "args": [
        "linkedparticles"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "particles": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "linkedparticles"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "particles": {
      "command": "uvx",
      "args": [
        "linkedparticles"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "particles": {
      "command": "uvx",
      "args": [
        "linkedparticles"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

## Tools

- `query`: Composes a cited natural-language answer from stored particles.
- `lint`: Checks the store for contradictions, staleness and orphaned links.
- `particle_show`: Shows one particle.
- `particles_list`: Lists particles.
- `graph_view`: Returns a graph view of the store.
- `quality_report`: Reports on store quality.

## FAQ

### Is the MCP server read-only?

By default yes; write tools turn on only for stores listed in the `mcp.write.enabled_stores` allowlist.

### Do I need a model API key?

Only for tools that call a model, such as `query` and semantic `lint`; read-only accessors work without it.

### What licence does it use?

Apache-2.0.

### Can it use a local model?

The README says any OpenAI-compatible endpoint works, including Ollama, llama.cpp and vLLM.

### Is Particles free?

Yes. Particles is open source, so you can use and self-host it for free.

### How do I add Particles to Claude Code?

Run this command in your terminal: claude mcp add particles --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- uvx linkedparticles

### What are the best alternatives to Particles?

The closest alternatives to Particles are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## 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.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/particles
