MCP Server

Remind can run as an MCP (Model Context Protocol) server, allowing AI agents in IDEs like Cursor to use it as their memory system over HTTP.

When to use MCP

MCP is a good fit when:

• Your IDE/agent supports MCP natively (Cursor, Claude Desktop, etc.)
• You want centralized memory across projects (databases at ~/.remind/)
• You want the agent to use Remind tools directly without shell access

For project-scoped memory with composable workflows, see Skills + CLI instead.

Starting the server

# After pip install
remind-mcp --port 8765

# Or with uv (no install needed)
uvx remind-mcp --port 8765

# Or with Docker
docker compose up -d

Connecting from Cursor

Add to your project's .cursor/mcp.json:

{
  "mcpServers": {
    "remind": {
      "url": "http://127.0.0.1:8765/sse?db=my-project"
    }
  }
}

The db parameter is a simple name that resolves to ~/.remind/{name}.db. Each project can have its own database.

Available tools

Full parameter lists and examples: MCP tools reference.

Summary:

Tool	Purpose
remember	Store an episode (returns collision info for facts)
recall	Spreading activation (+ optional entity, topic, as_of)
snapshot	Batch read (pending episodes, conflicts, entities, topics, concepts)
apply	Batch write (create concepts, supersede facts, resolve conflicts)
stats	Memory statistics
list_topics	List topics with counts
create_topic / update_topic / delete_topic	Manage topics
topic_overview	Top concepts for a topic

Agent instructions

Copy docs/AGENTS.md into your project to instruct AI agents how to use Remind's MCP tools. This covers:

• Capture — When and how to use remember (including fact collisions)
• Recall — Semantic, entity, and topic-scoped queries with time-travel
• Curation — Using snapshot and apply for batch memory management

Docker

Run Remind as a persistent background service:

docker compose up -d

The container:

• Mounts ~/.remind from your host for database persistence
• Exposes port 8765 for MCP SSE, Web UI, and REST API
• Uses local embeddings by default (no API keys needed)
• Restarts automatically on crash/reboot

Access endpoints:

• MCP SSE: http://localhost:8765/sse?db=my-project
• Web UI: http://localhost:8765/ui/?db=my-project
• REST API: http://localhost:8765/api/v1/...

Optional: Remote embeddings

To use OpenAI embeddings instead of local:

cp .env.example .env   # Edit with OPENAI_API_KEY
docker compose up -d

Or set environment variables when running the server directly.