Skip to main content

MCP server for Recollect

Project description

recollect-mcp

MCP server that gives AI assistants persistent, human-like memory via the Recollect SDK.

Install

pip install recollect-mcp

Usage

# stdio transport (default)
recollect-mcp

# streamable-http transport (production)
recollect-mcp --transport http

MCP Client Config

Add to .mcp.json or claude_desktop_config.json:

{
  "mcpServers": {
    "memory": {
      "command": "recollect-mcp",
      "args": []
    }
  }
}

Tools

Tool Description
remember Store an experience as a memory trace with LLM-extracted patterns
recall Retrieve relevant memories for a query within a token budget
pin Promote a memory so it resists decay
unpin Remove promotion from a previously pinned memory
forget Weaken or remove a memory trace

Resources

Resource Description
primer Relational graph built from extracted persona facts
facts Raw persona facts with temporal weighting
health Server and database health status

Requirements

  • Python 3.12+
  • PostgreSQL 17 with pgvector
  • ANTHROPIC_API_KEY environment variable (for LLM pattern extraction)

Sessions are managed server-side -- no session configuration needed from the client.

License

See LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

recollect_mcp-0.3.0.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

recollect_mcp-0.3.0-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

Details for the file recollect_mcp-0.3.0.tar.gz.

File metadata

  • Download URL: recollect_mcp-0.3.0.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for recollect_mcp-0.3.0.tar.gz
Algorithm Hash digest
SHA256 4afbc4f6018d91d822632da2230eefdc2deffe2a32878ea4908645570a391788
MD5 6e03c08d6c895de93bf73562000957ba
BLAKE2b-256 d3d64abe71b5843ff541ff8ea1ca295b8f5b5a37071e3bdbadb731ca43dbeccc

See more details on using hashes here.

File details

Details for the file recollect_mcp-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: recollect_mcp-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 5.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for recollect_mcp-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 25d42c9eeef79321d0826858cd220440783554fc5551a3bdc38fe9f491bc4812
MD5 2008934eaebeb928f8b9a258f1364fbf
BLAKE2b-256 ef030e083899d1c4bcefcef3b2cfe42831ddb086c24cae2a97938db341c66227

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page