# Apiary Memory

> Apiary Memory is a free MCP server for knowledge and memory. Local-first shared memory for AI agents where only you confirm what is saved. It runs locally on your machine and is started by your AI client.

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

## About

Several AI clients can share one memory that lives on your own computer instead of with each vendor. Agents can only propose candidates; writing to the official memory needs your approval in the app, which the site frames as a governance rule rather than a setting.

Retrieval blends keyword and semantic ranking, using a roughly 100 MB model installed locally, so queries stay on the machine and fall back to keyword search if the model fails. Passwords, keys and bank cards go into a local encrypted area. The site gives 54 ms hot search on 1,485 memories and says it handles a million at about 0.6 seconds.

The desktop app is free on the Mac App Store, iOS is listed, and Windows and Linux are marked coming soon. The MCP server is also on PyPI as apiary-memory, with local, auto and remote modes. The site is in Chinese.

## Features

- **Propose, then confirm:** Agents submit candidates; you approve them before they become memory.
- **Local storage:** Data stays in a local database, with no account or telemetry.
- **Hybrid search:** Keyword and semantic ranking fused, with fallback to keywords.
- **Encrypted private area:** Keeps passwords, keys and cards in local encryption.
- **Agent board:** A shared board shows which agent is doing what.
- **Backup and export:** Whole-library backup, migration and standard-format export.

## Good for

- Carry context from one AI client to another
- Keep notes and preferences off vendor servers
- Review what an agent wants to remember
- Search years of saved notes offline

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `recall`: Search saved memory.
- `propose`: Submit a candidate memory for approval.
- `manage`: Manage stored memory.
- `get_context`: Fetch your context when an agent connects.
- `say`: Post to the collaboration board.
- `board`: Read the collaboration board.

## FAQ

### Can an agent write memory directly?

No. Agents propose candidates and you confirm.

### Which tools does it expose?

recall, propose, manage, get_context, say and board.

### Does it need an account?

No. The site says no account, no telemetry and no cloud by default.

### Is Apiary Memory free?

Yes. Apiary Memory is free to use.

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

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

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

The closest alternatives to Apiary Memory 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/apiary-memory
