# Memory Hive

> Memory Hive is a freemium MCP server for knowledge and memory. Local-first shared memory for AI agents where nothing is stored until you approve it. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** macOS, iOS, CLI
- **Website:** https://hello-fengchao.com
- **Repository:** https://github.com/330899935/memory-hive-mcp
- **MCP Registry name:** io.github.330899935/hive-memory
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-16

## About

Memory Hive, now called Apiary Memory, keeps one memory store on your own computer that several AI assistants read from. The key rule is that agents can only propose what to remember. A proposal lands in a candidate queue, and nothing enters the confirmed memory until you approve it, in the app or with the pip package's apiary-memory-cli list and approve commands.

The pip package is the open-source MIT integration layer, in plain Python, using a local SQLite file. It searches by words only, whereas the closed-source macOS app from version 1.5.0 adds a local vector model fused with keyword ranking so you can search by meaning. The README is explicit that the pip package has no GUI and that there is no Windows desktop app. The product's site lists six tools: recall, propose, manage, get_context, say and board, with a board for several AIs to hand off work.

The site describes no account, no cloud and no telemetry, with passwords and keys going into an encrypted local area. The macOS and iOS apps are free on the App Store with a free basic tier and subscriptions for the full feature set.

## Features

- **Propose, then approve:** Agents submit candidates and only you can confirm them into memory.
- **Local SQLite store:** Memory lives in one file on your disk, by default under ~/.memory-hive.
- **Shared across AIs:** Any MCP client can read the same memory, so switching assistants keeps context.
- **Human CLI:** apiary-memory-cli lists, approves and searches pending candidates.
- **Semantic search in the app:** The macOS app adds a local vector model with keyword fusion, while the pip package is keyword-only.
- **Collaboration board:** Several AIs can hand off work with tasks waiting for your decision pinned on top.

## Good for

- Keep project background once and reuse it across Claude, Cursor and Codex
- Let an agent suggest facts to remember while you review them
- Search past notes offline on your own machine
- Move to a new AI without re-explaining yourself
- Keep sensitive details such as keys in a local encrypted area

## Install

### Claude Code (Terminal)

```sh
claude mcp add hive-memory --env HIVE_AGENT_TOKEN='<HIVE_AGENT_TOKEN>' -- uvx memory-hive-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hive-memory": {
      "command": "uvx",
      "args": [
        "memory-hive-mcp"
      ],
      "env": {
        "HIVE_AGENT_TOKEN": "<HIVE_AGENT_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hive-memory": {
      "command": "uvx",
      "args": [
        "memory-hive-mcp"
      ],
      "env": {
        "HIVE_AGENT_TOKEN": "<HIVE_AGENT_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "hive-memory": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "memory-hive-mcp"
      ],
      "env": {
        "HIVE_AGENT_TOKEN": "<HIVE_AGENT_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hive-memory": {
      "command": "uvx",
      "args": [
        "memory-hive-mcp"
      ],
      "env": {
        "HIVE_AGENT_TOKEN": "<HIVE_AGENT_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hive-memory": {
      "command": "uvx",
      "args": [
        "memory-hive-mcp"
      ],
      "env": {
        "HIVE_AGENT_TOKEN": "<HIVE_AGENT_TOKEN>"
      }
    }
  }
}
```

## Tools

- `recall`: Searches confirmed memory.
- `propose`: Proposes a candidate memory for approval.
- `manage`: Manages stored memory.
- `get_context`: Returns context for the agent.
- `say`: Posts a message to the collaboration board.
- `board`: Shows the collaboration board.

## FAQ

### Can an agent write directly to my memory?

No. Agents can only propose candidates, and nothing is stored until you approve it.

### Does it send data to the cloud?

The README says it has no account, no cloud and no telemetry, and the server runs on your own machine.

### Is it fully open source?

Only the MCP integration layer is MIT-licensed. The macOS and iOS apps are closed source.

### Is there a Windows version?

The README says there is no Windows desktop app, but the pip package runs on any OS with Python 3.8 or newer.

### Does the pip package search by meaning?

No. It searches lexically only. Semantic search is in the macOS app from 1.5.0.

### Is Memory Hive free?

Memory Hive has a free plan, with paid plans for more usage or features.

### How do I add Memory Hive to Claude Code?

Run this command in your terminal: claude mcp add hive-memory --env HIVE_AGENT_TOKEN='<HIVE_AGENT_TOKEN>' -- uvx memory-hive-mcp

### What are the best alternatives to Memory Hive?

The closest alternatives to Memory Hive 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/memory-hive
