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.1.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.1-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: recollect_mcp-0.3.1.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.1.tar.gz
Algorithm Hash digest
SHA256 2a08825b21ce4862b7726492131614e61306656d738a23c73c9a8c720c40e9a5
MD5 db6a0c1c32572014924ac714828d4eb9
BLAKE2b-256 c657a471200bf028cd83ed8f1c5a71af741f12f6b706b803951ae67b72a728ba

See more details on using hashes here.

File details

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

File metadata

  • Download URL: recollect_mcp-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 6.1 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6464e1410cd622955dae458202f75cd915d3c9c7acc7bdd8e047a6ead76e6fa0
MD5 a97c7986e6a1d7e6dfaa43cb492a3ec5
BLAKE2b-256 56e70449dbd60f84d0771634b72b350005fe7f4c2def8af5f540000496362cd2

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