# Awareness Local

> Awareness Local is a freemium MCP server for knowledge and memory. Local-first persistent memory for coding agents, stored as Markdown on your machine. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Website:** https://awareness.market
- **Repository:** https://github.com/everest-an/awareness-market
- **MCP Registry name:** io.github.everest-an/awareness-local
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-14

## About

Awareness stores decisions, solutions, risks and preferences as plain Markdown in a .awareness folder, indexes them with SQLite FTS5 plus embeddings, and recalls them in later sessions of Cursor, Claude Code, Copilot, Cline, Windsurf and other MCP clients. A single command, npx @awareness.market/setup, installs a lightweight local daemon and writes the MCP config and workflow rules so the agent knows when to recall and record.

Retrieval combines keyword, vector and knowledge-graph search without LLM calls. The project reports 96.0% Recall@5 on the LongMemEval benchmark over its 500 questions and says scripts to reproduce it are included. It also claims around 60% fewer context tokens through compression. These are the vendor's own figures. It runs fully offline with no account; ChatGPT Desktop can connect to the local daemon at http://127.0.0.1:37800/mcp.

Cloud sync is optional and adds team sharing, semantic search and multi-device access. The pricing page positions it as a memory database rather than an agent runtime or general vector database.

## Features

- **Markdown memory:** Memories are plain files in .awareness with a local SQLite index.
- **Hybrid recall:** Keyword, vector and graph retrieval with no LLM calls.
- **One-command setup:** npx @awareness.market/setup configures MCP and rules.
- **Knowledge cards:** Extracts decisions, solutions and risks as structured records.
- **Offline use:** Works without an account or network.
- **Optional cloud sync:** Add team sync and multi-device access when needed.

## Good for

- Keep context across long codebase migrations
- Hand off project knowledge between teammates' agents
- Retain coding conventions and preferences between sessions
- Share decision history among several agents

## Install

### Claude Code (Terminal)

```sh
claude mcp add awareness-local -- npx -y @awareness.market/local
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "awareness-local": {
      "command": "npx",
      "args": [
        "-y",
        "@awareness.market/local"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "awareness-local": {
      "command": "npx",
      "args": [
        "-y",
        "@awareness.market/local"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "awareness-local": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@awareness.market/local"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "awareness-local": {
      "command": "npx",
      "args": [
        "-y",
        "@awareness.market/local"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "awareness-local": {
      "command": "npx",
      "args": [
        "-y",
        "@awareness.market/local"
      ]
    }
  }
}
```

## FAQ

### Does it work offline?

Yes. Local mode works fully offline with data on your machine.

### Do I need an account?

No. Cloud sync is optional.

### What does the free plan include?

One memory library, one seat, 1,000 API calls a month and 100 MB of storage.

### Where is data kept?

As Markdown in .awareness, with a local SQLite index.

### Is Awareness Local free?

Awareness Local has a free plan, with paid plans for more usage or features.

### How do I add Awareness Local to Claude Code?

Run this command in your terminal: claude mcp add awareness-local -- npx -y @awareness.market/local

### What are the best alternatives to Awareness Local?

The closest alternatives to Awareness Local are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [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.

---
Source: https://ai-powered.com/mcp/awareness-local
