Subconscious MCP Server

by vishaltorc Your server? Claim it

local only

Subconscious runs on your own machine — the client starts it, so there is no endpoint to ping. 70 installs a week from pypi. Last commit 15 Jun 2026.

Local-first semantic memory for MCP agents. Recall, remember, forget, echo, drift, stats over stdio.

Installs per day peak 20 · avg 9 · +6% w/w

a month agotoday

Installs / week

pypi · subconscious-mcp

Stars

9 open issues

15 Jun 2026

Last commit

0 releases in 90 days

MIT

License

Python

What the code does

We read the source, 22 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command src/subconscious_mcp/hookcli.py:41

        out = subprocess.run(["git", "-C", str(cwd), "rev-parse", "--show-toplevel"],

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add subconscious-mcp -- uvx subconscious-mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "subconscious-mcp": {
      "args": [
        "subconscious-mcp"
      ],
      "command": "uvx"
    }
  }
}

~/.codex/config.toml

[mcp_servers.subconscious-mcp]
command = "uvx"
args = ["subconscious-mcp"]

.cursor/mcp.json

{
  "mcpServers": {
    "subconscious-mcp": {
      "args": [
        "subconscious-mcp"
      ],
      "command": "uvx"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "subconscious-mcp": {
      "args": [
        "subconscious-mcp"
      ],
      "command": "uvx"
    }
  }
}

Alternatives to Subconscious

same job, measured the same way

Norn

by samad001z

Local-first, persistent memory for AI coding agents — remember, recall, forget, and list, over MCP.

50 installs/wk local only

Tether

by sidyellur

Local-first agent memory over SQLite: remember, recall, link, forget. Degrades, never fails.

local only

Kairn

by primeline-ai

Local-first knowledge engine for AI agents: memory, graph, and recall over MCP.

local only

Monet

by team-monet

Local-first, state-centric memory for coding agents. MCP server + CLI.

107 installs/wk local only

StremAI

by thomasjumper

StremAI MCP: shared memory for AI coding agents. Connected agents can recall. OAuth + local stdio.

96 installs/wk answering

Prism Coder

by dcostenco

Session memory for coding agents: local-first recall, drift detection, on-device inference.

1 183 installs/wk local only

Mnema

by zimac

Local-first, formally verified memory for AI agents: consult/learn/related/list over MCP.

local only

Plur

by plur-ai

Open, local-first engram memory for AI agents: read, correct, delete; shared over MCP.

785 installs/wk local only

Subconscious — questions

Answers built from our own checks of this server.

Why is there no uptime for Subconscious?

Subconscious runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package subconscious-mcp was installed 70 times last week.

How do I connect Subconscious?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls subconscious-mcp straight from pypi; nothing to host, nothing to sign up for.

How many people use Subconscious?

The pypi package subconscious-mcp was installed 70 times in the last week. Week over week that is +6%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Subconscious open source?

Yes — it is published under the MIT licence, written in Python, 0 stars on GitHub and 9 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.