MarsNMe

Agent-agnostic memory backend that preserves continuity between humans and AI over time.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "marsnme": {
      "command": "npx",
      "args": [
        "-y",
        "@marsnme/mcp-gateway"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (16)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by MarsNMe.

insert_memory

Store short-term memory

list_memories

List recent memories

search_memories

Semantic search via Jina embeddings

recall

Long-term chunk recall — ~80-char preview per match

get_summary

Medium excerpt (~300 chars) of a chunk by ID

get_full

Complete text of a long-term chunk by ID

Documentation Overview

English | 繁體中文（台灣） | 繁體中文（香港） | 简体中文

marsnme.com — Claude.md is for context. MarsNMe is for continuity.

Your AI tools should know you — not start from scratch every time. When Perplexity helps you decide, Claude should remember why. When Cursor ships a feature, Warp should know the context. That's not context sharing. That's continuity.

Most AI memory tools help AI remember you. MarsNMe helps you and your AI remember each other — across sessions, across tools, over time.

An agent-agnostic, LLM-agnostic memory backend for MCP-compatible tools.

Terminal

curl -fsSL https://marsnme.com/install.sh | bash

MarsNMe dark mode demo

MarsNMe light mode demo

Real user story

I use Cursor to code, Warp to deploy, Perplexity to research, and Claude Code to manage my vault. Before MarsNMe, every tool started blank — I had to re-explain my project, my preferences, my decisions every single session. Now my AI across all four tools knows what we decided yesterday, what we tried last week, and why we chose this architecture over that one. It's not about injecting context. It's about having a relationship that compounds over time.

— Leo, MarsNMe creator (3 months of daily use across 4 AI tools)

Available MCP Tools (16)

Tool	Description
`insert_memory`	Store short-term memory
`list_memories`	List recent memories
`search_memories`	Semantic search via Jina embeddings
`recall`	Long-term chunk recall — ~80-char preview per match
`get_summary`	Medium excerpt (~300 chars) of a chunk by ID
`get_full`	Complete text of a long-term chunk by ID
`memory_ingest`	Ingest long-term insight chunks
`dream_ingest`	Dream-mode long-term ingestion
`session_boot`	Start a session with context pre-load
`session_close`	Close session, summarize, auto-promote expiring memories
`health_check`	Coverage, expiry, conflict diagnostics
`reload_source_registry`	Refresh source whitelist at runtime
`demote_memory`	Demote a memory to lower priority
`soft_forget`	Soft-delete a memory
`explain_memory`	Explain a memory's provenance
`batch_promote`	Promote expiring short-term memories to long-term

What's new in 0.3.0

3-layer recall: recall returns ~80-char previews, then get_summary (~300 chars), then get_full (complete). Avoids token-dumping full chunks on every recall; drill down only when a preview looks relevant.
Body-to-body note handoff: session_close(to=<body>, note=...) leaves a note that session_boot(body=<target>) delivers and marks read — one agent can hand context to another.
Auto batch_promote on session_close: closing a session automatically promotes soon-expiring short-term memories (48h window, up to 5) to long-term storage — no Hermes or manual promote needed.
grok + draft sources: added to the source whitelist so the Grok body and Draft lifecycle hooks can write memories natively.
CoCo-only tool surface: PRD tools (save_prd, get_prd, list_prds, score_prd, spawn_to_linear) removed from the Supabase gateway — idea/PRD/task execution now lives in Draft. MarsNMe = CoCo soul memory only.

MarsNMe

Why MarsNMe?

Most AI memory tools help AI remember you. MarsNMe helps you and your AI remember each other.

	MarsNMe	Typical memory tool
Philosophy	Mutual continuity — human + AI both grow	AI-side context injection only
Agent support	Any MCP-compatible client	Often client-specific
Memory tiers	Short-term (TTL) + long-term (semantic)	Usually one layer
Profiles	Unlimited isolated profiles via `MCP_PROFILE`	Single-user only
Data ownership	Your own Supabase — zero vendor lock-in	Vendor-hosted
Search	Jina v3 semantic search (1024-dim pgvector)	Keyword or basic similarity
Self-hostable	✅ Full control	Rarely

When MarsNMe is the right fit

You use multiple AI assistants (Claude, Cursor, Perplexity, Warp, custom agents) and want shared memory across all of them
You want AI that remembers your projects, preferences, and decisions across sessions without re-explaining
You care about data sovereignty — your memories stay in your own Supabase project
You're building an AI agent and need a production-ready memory backend with semantic recall

When it might not be the right fit

You only need single-session context (just use the system prompt)
You want fully managed, zero-config memory with no setup (try a hosted solution)

Runtime packages

Folder	Runtime	Who uses it
`marsnme-supabase/`	Supabase + Jina gateway (`@marsnme/mcp-gateway`)	Mars Group dogfood — Proxmox CT101 (CoCo / Toto soul memory)
`marsnme-cf/`	Cloudflare Workers + D1 + Vectorize	Self-host template; not the Proxmox deploy path
`marsnme-supabase/cloudflare-routing-worker/`	`mcp.marsnme.com` routing proxy	Public setup wizard → upstream gateway

Product split (Mars Group): Idea / PRD / task execution → Draft + draft-mcp. MarsNMe Supabase = CoCo soul memory only (recall, session boot/close, ingest, lifecycle). As of @marsnme/mcp-gateway v0.3.0, PRD MCP tools (save_prd, get_prd, list_prds, score_prd, spawn_to_linear) are removed from the Supabase gateway — use Draft for idea/PRD/task workflows.

Proxmox deploy: private MarsNMe-lab — deploy/deploy-proxmox-ct101.sh or GitHub cd-selfhosted workflow. Not a single-script deploy like draft-mcp.

Repository Packages

Package	Description
`marsnme-supabase/`	Core MCP gateway — agent-agnostic memory backend (this package is published to npm as `@marsnme/mcp-gateway`)
`marsnme-supabase/cloudflare-routing-worker/`	Cloudflare Worker for `mcp.marsnme.com` — username-based MCP routing proxy with setup wizard
`marsnme-cf/`	Self-hosted MCP memory server on Cloudflare Workers + D1 + Vectorize (no Supabase needed)

Quick Setup (no install needed)

Go to mcp.marsnme.com/setup — create your personal MCP URL in 4 steps:

Pick a username
Enter your Supabase credentials (URL + anon key)
Choose preferences
Get your MCP URL: https://mcp.marsnme.com/your-name

Then add it to any MCP client (Claude, Cursor, Perplexity, Warp).

Self-hosted? Deploy marsnme-cf/ to your own Cloudflare account — no Supabase needed, uses D1 + Workers AI + Vectorize.

Before You Start (External Dependencies)

Create a Supabase project (free plan is enough):
- Sign up: https://supabase.com
- Create project: https://supabase.com/dashboard/new
- Open API settings (Project Settings → API):
  - Project URL → SUPABASE_BASE_URL
  - service_role key → SUPABASE_SERVICE_ROLE_KEY
- Keep SUPABASE_SERVICE_ROLE_KEY private. Never commit it.
Create a Jina API key (free tier available):
- Get key: https://jina.ai/api-key/
- Copy key to JINA_API_KEY

Quick Start (15-20 minutes)

For the fastest path, use the one-line installer: curl -fsSL https://marsnme.com/install.sh | bash

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

14M

Package downloads in the last 30 days.

Last commit

8d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MarsNMe

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "marsnme": { "command": "npx", "args": ["-y","@marsnme/mcp-gateway"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/marsnme?style=directory)](https://allmcps.com/mcp/marsnme)

HTML Embed

<a href="https://allmcps.com/mcp/marsnme"><img src="https://allmcps.com/api/badge/marsnme?style=directory" alt="MarsNMe on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

10/15 checks healthy over the last 46d

59Quality signal: Good · 59/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity9/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · @marsnme/mcp-gateway (npm)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to MarsNMe →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

MarsNMe

Agent-agnostic memory backend that preserves continuity between humans and AI over time.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "marsnme": {
      "command": "npx",
      "args": [
        "-y",
        "@marsnme/mcp-gateway"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (16)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by MarsNMe.

insert_memory

Store short-term memory

list_memories

List recent memories

search_memories

Semantic search via Jina embeddings

recall

Long-term chunk recall — ~80-char preview per match

get_summary

Medium excerpt (~300 chars) of a chunk by ID

get_full

Complete text of a long-term chunk by ID

Documentation Overview

English | 繁體中文（台灣） | 繁體中文（香港） | 简体中文

marsnme.com — Claude.md is for context. MarsNMe is for continuity.

Most AI memory tools help AI remember you. MarsNMe helps you and your AI remember each other — across sessions, across tools, over time.

An agent-agnostic, LLM-agnostic memory backend for MCP-compatible tools.

Terminal

curl -fsSL https://marsnme.com/install.sh | bash

MarsNMe dark mode demo

MarsNMe light mode demo

Real user story

I use Cursor to code, Warp to deploy, Perplexity to research, and Claude Code to manage my vault. Before MarsNMe, every tool started blank — I had to re-explain my project, my preferences, my decisions every single session. Now my AI across all four tools knows what we decided yesterday, what we tried last week, and why we chose this architecture over that one. It's not about injecting context. It's about having a relationship that compounds over time.

— Leo, MarsNMe creator (3 months of daily use across 4 AI tools)

Available MCP Tools (16)

Tool	Description
`insert_memory`	Store short-term memory
`list_memories`	List recent memories
`search_memories`	Semantic search via Jina embeddings
`recall`	Long-term chunk recall — ~80-char preview per match
`get_summary`	Medium excerpt (~300 chars) of a chunk by ID
`get_full`	Complete text of a long-term chunk by ID
`memory_ingest`	Ingest long-term insight chunks
`dream_ingest`	Dream-mode long-term ingestion
`session_boot`	Start a session with context pre-load
`session_close`	Close session, summarize, auto-promote expiring memories
`health_check`	Coverage, expiry, conflict diagnostics
`reload_source_registry`	Refresh source whitelist at runtime
`demote_memory`	Demote a memory to lower priority
`soft_forget`	Soft-delete a memory
`explain_memory`	Explain a memory's provenance
`batch_promote`	Promote expiring short-term memories to long-term

What's new in 0.3.0

3-layer recall: recall returns ~80-char previews, then get_summary (~300 chars), then get_full (complete). Avoids token-dumping full chunks on every recall; drill down only when a preview looks relevant.
Body-to-body note handoff: session_close(to=<body>, note=...) leaves a note that session_boot(body=<target>) delivers and marks read — one agent can hand context to another.
Auto batch_promote on session_close: closing a session automatically promotes soon-expiring short-term memories (48h window, up to 5) to long-term storage — no Hermes or manual promote needed.
grok + draft sources: added to the source whitelist so the Grok body and Draft lifecycle hooks can write memories natively.
CoCo-only tool surface: PRD tools (save_prd, get_prd, list_prds, score_prd, spawn_to_linear) removed from the Supabase gateway — idea/PRD/task execution now lives in Draft. MarsNMe = CoCo soul memory only.

MarsNMe

Why MarsNMe?

Most AI memory tools help AI remember you. MarsNMe helps you and your AI remember each other.

	MarsNMe	Typical memory tool
Philosophy	Mutual continuity — human + AI both grow	AI-side context injection only
Agent support	Any MCP-compatible client	Often client-specific
Memory tiers	Short-term (TTL) + long-term (semantic)	Usually one layer
Profiles	Unlimited isolated profiles via `MCP_PROFILE`	Single-user only
Data ownership	Your own Supabase — zero vendor lock-in	Vendor-hosted
Search	Jina v3 semantic search (1024-dim pgvector)	Keyword or basic similarity
Self-hostable	✅ Full control	Rarely

When MarsNMe is the right fit

You use multiple AI assistants (Claude, Cursor, Perplexity, Warp, custom agents) and want shared memory across all of them
You want AI that remembers your projects, preferences, and decisions across sessions without re-explaining
You care about data sovereignty — your memories stay in your own Supabase project
You're building an AI agent and need a production-ready memory backend with semantic recall

When it might not be the right fit

You only need single-session context (just use the system prompt)
You want fully managed, zero-config memory with no setup (try a hosted solution)

Runtime packages

Folder	Runtime	Who uses it
`marsnme-supabase/`	Supabase + Jina gateway (`@marsnme/mcp-gateway`)	Mars Group dogfood — Proxmox CT101 (CoCo / Toto soul memory)
`marsnme-cf/`	Cloudflare Workers + D1 + Vectorize	Self-host template; not the Proxmox deploy path
`marsnme-supabase/cloudflare-routing-worker/`	`mcp.marsnme.com` routing proxy	Public setup wizard → upstream gateway

Proxmox deploy: private MarsNMe-lab — deploy/deploy-proxmox-ct101.sh or GitHub cd-selfhosted workflow. Not a single-script deploy like draft-mcp.

Repository Packages

Package	Description
`marsnme-supabase/`	Core MCP gateway — agent-agnostic memory backend (this package is published to npm as `@marsnme/mcp-gateway`)
`marsnme-supabase/cloudflare-routing-worker/`	Cloudflare Worker for `mcp.marsnme.com` — username-based MCP routing proxy with setup wizard
`marsnme-cf/`	Self-hosted MCP memory server on Cloudflare Workers + D1 + Vectorize (no Supabase needed)

Quick Setup (no install needed)

Go to mcp.marsnme.com/setup — create your personal MCP URL in 4 steps:

Pick a username
Enter your Supabase credentials (URL + anon key)
Choose preferences
Get your MCP URL: https://mcp.marsnme.com/your-name

Then add it to any MCP client (Claude, Cursor, Perplexity, Warp).

Self-hosted? Deploy marsnme-cf/ to your own Cloudflare account — no Supabase needed, uses D1 + Workers AI + Vectorize.

Before You Start (External Dependencies)

Create a Supabase project (free plan is enough):
- Sign up: https://supabase.com
- Create project: https://supabase.com/dashboard/new
- Open API settings (Project Settings → API):
  - Project URL → SUPABASE_BASE_URL
  - service_role key → SUPABASE_SERVICE_ROLE_KEY
- Keep SUPABASE_SERVICE_ROLE_KEY private. Never commit it.
Create a Jina API key (free tier available):
- Get key: https://jina.ai/api-key/
- Copy key to JINA_API_KEY

Quick Start (15-20 minutes)

For the fastest path, use the one-line installer: curl -fsSL https://marsnme.com/install.sh | bash

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

14M

Package downloads in the last 30 days.

Last commit

8d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MarsNMe

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "marsnme": { "command": "npx", "args": ["-y","@marsnme/mcp-gateway"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/marsnme?style=directory)](https://allmcps.com/mcp/marsnme)

HTML Embed

<a href="https://allmcps.com/mcp/marsnme"><img src="https://allmcps.com/api/badge/marsnme?style=directory" alt="MarsNMe on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

10/15 checks healthy over the last 46d

59Quality signal: Good · 59/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity9/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · @marsnme/mcp-gateway (npm)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.