Skip to content
MCP server

Awareness Local

Local-first persistent memory for coding agents, stored as Markdown on your machine

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.21.1
Listing updated
2 days ago

About Awareness Local

Awareness Local is a freemium MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "awareness-local": {
      "command": "npx",
      "args": [
        "-y",
        "@awareness.market/local"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "awareness-local": {
      "command": "npx",
      "args": [
        "-y",
        "@awareness.market/local"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Freemium

Free plan; Team adds 5 seats and 500K calls a month; Enterprise by arrangement

Prices change. Check awareness.market before you buy.

Awareness 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 to Awareness Local

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools