At a Glance
| Type | Name | What it does | Who uses it |
|---|---|---|---|
| Tool | add_memory | Save personal context to long-term memory | Agent calls automatically when it learns something worth remembering |
| Tool | search_memory | Search past memories by meaning | Agent calls when past context would help its response |
| Tool | get_current_date | Get current date and time in a timezone | Agent calls before date-filtered memory search |
| Tool | add_wiki | Add a factual knowledge document to the wiki | Agent calls when user shares stable, reference-style knowledge |
| Tool | search_wiki | Hybrid search across wiki documents | Agent calls when factual knowledge would improve its response |
| Tool | update_wiki | Edit an existing wiki document | Agent calls to keep a document current |
| Tool | delete_wiki | Permanently remove a wiki document | Agent calls with user confirmation |
| Resource | membase://profile | Read-only user settings profile | Agent reads when stable profile context matters |
| Resource | membase://recent | Read-only recent memory timeline | Agent reads for latest updates and recency checks |
| Prompt | start | Guidance for memory workflow and safety | Agent can load at session start |
Memory vs Wiki
Membase exposes two complementary stores through MCP:- Memory (
add_memory,search_memory): Personal context that describes the user: preferences, decisions, habits, ongoing projects. - Wiki (
add_wiki,search_wiki,update_wiki,delete_wiki): Factual knowledge that the user wants to keep as reference material: docs, specs, notes, and anything else that is stable and addressable by title.
search_memory and search_wiki, then combine the results. See the Knowledge Wiki guide for details.
MCP Server
Membase runs a remote MCP server accessible at:| Property | Value |
|---|---|
| Transport | Streamable HTTP |
| Authentication | OAuth (browser-based) |
| Package | membase (npm) |
npx -y membase@latest --client <client> CLI command handles registration and auth automatically for supported clients. See the Agents guide for per-client setup.
Claude Code users should start with the Membase Claude Code plugin. The plugin exposes the same Membase memory and wiki tools directly inside Claude Code, plus slash commands, hooks, and project-aware workflows. The remote MCP server remains available for other clients and as a Claude Code fallback.
Tools
Membase exposes tools that agents can call during conversations. They split into two groups: memory tools for personal context and wiki tools for factual knowledge.Memory Tools
add_memory
add_memory
Stores long-term memory that persists across sessions. Agents use this proactively when the user shares durable context worth remembering: preferences, recurring habits, ongoing projects, goals, constraints, etc. Transient one-off information is skipped unless the user explicitly asks to save it.
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string (max 50,000 chars) | Yes | The memory content to store |
project | string (max 60 chars) | No | Project or category slug to file this memory under. Agents should only set this when the user explicitly mentions a project name, tag, label, or category (e.g. “save this under project X”, “tag this as Y”). Do not guess or infer. See Projects. |
metadata | object | No | Reserved for internal use. Agents should not populate this field. |
search_memory
search_memory
Searches stored memories by semantic similarity. Agents use this when the user asks to recall something from a previous session, or proactively when past context would improve their response. Results are returned as episode-centric bundles with related context.
Each result includes a relevance score (0–1) indicating how closely it matches the query.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string (max 1,000 chars) | Yes | Natural-language search query. Use empty string to fetch recent memories. |
limit | integer (1-30) | No | Max results to return (default: 20) |
offset | integer | No | Pagination offset (default: 0) |
date_from | ISO date/datetime string | No | Inclusive lower bound for date filtering |
date_to | ISO date/datetime string | No | Inclusive upper bound for date filtering |
timezone | IANA timezone string | No | Date-only parsing timezone, for example America/Los_Angeles |
sources | array of strings | No | Filter by source. Supports integrations (Slack, Gmail, Google Calendar), AI clients (Cursor, Claude, Claude Code, VS Code, ChatGPT, Codex, Gemini CLI, OpenCode, Poke, OpenClaw, Hermes), imports (ChatGPT, Claude, Gemini), and dashboard-created memories. If omitted, all sources are searched. |
project | string (max 60 chars) | No | Restrict search to a single project slug (exact match). Use only when the user explicitly asks for a project or category scope. See Projects. |
get_current_date
get_current_date
Returns the current date and time in the user’s Membase timezone (and UTC). Agents call this before
search_memory to resolve relative phrases like “today”, “yesterday”, “this week”, or “next weekend” into ISO 8601 date_from/date_to values.This tool takes no input parameters. The response contains four fields:| Field | Description |
|---|---|
now_utc | Current UTC timestamp in ISO 8601 (e.g., 2025-01-15T02:30:00.000Z) |
timezone | The effective IANA timezone used (from the user’s saved Membase timezone) |
local_date | Local date in that timezone (e.g., 2025-01-15) |
local_time | Local time in that timezone (e.g., 11:30:00) |
Projects
Memories can be grouped into projects (lightweight category/tag slugs). Bothadd_memory and search_memory accept an optional project field.
- User-driven, not inferred: Agents should set
projectonadd_memoryonly when the user explicitly mentions a project, tag, label, or category (for example, “save this underacme-rewrite”, “tag this aspersonal”). Agents must not guess or invent a project. - Known projects hint: The Membase MCP server injects the current user’s existing project slugs into each tool’s description, so agents can reuse existing slugs instead of creating new ones for the same concept.
- Filtered search: Pass
project: "acme-rewrite"tosearch_memoryto restrict results to that project. Exact slug match only. - Managed in the dashboard: Users can move memories between projects and filter by project from the Memories tab. See the Memory guide.
Wiki Tools
add_wiki
add_wiki
Creates a new document in the user’s knowledge wiki. Agents use this for factual, reference-style knowledge (documentation, specs, stable notes). Personal preferences and habits should go through
Document creation respects the user’s plan quota. If the limit is reached the call returns a quota error.
add_memory instead.| Parameter | Type | Required | Description |
|---|---|---|---|
title | string (1-500 chars) | Yes | Title of the wiki document |
content | string (max 100,000 chars) | Yes | Markdown content. Use [[wikilinks]] to reference related documents. |
collection | string (max 200 chars) | No | Place the document in a collection by name. New collections are created on first use. |
summarize | boolean | No | If true, Membase runs a context-aware LLM summarization pass over the content before saving (default: false) |
search_wiki
search_wiki
Searches the user’s wiki using hybrid search: a full-text keyword index (BM25-style) and semantic similarity, fused with Reciprocal Rank Fusion (RRF). Results include each document’s full body so the agent has enough context to answer immediately.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string (max 1,000 chars) | Yes | Natural-language or keyword search query. Use empty string "" to fetch recent wiki documents. |
limit | integer (1-20) | No | Max results to return (default: 10) |
collection | string (max 200 chars) | No | Restrict results to a specific wiki collection by name. If omitted, all collections are searched. |
update_wiki
update_wiki
Edits an existing wiki document. Use
search_wiki first to resolve the document ID.| Parameter | Type | Required | Description |
|---|---|---|---|
doc_id | UUID | Yes | ID of the document to update |
title | string (1-500 chars) | No | New title |
content | string (max 100,000 chars) | No | New markdown content |
collection | string or null (max 200 chars) | No | Move the document to a collection by name. New collections are created on first use. Set collection to null to move it to Basic Collection. |
delete_wiki
delete_wiki
Permanently deletes a wiki document. This action cannot be undone; agents should ask for user confirmation before calling it.
| Parameter | Type | Required | Description |
|---|---|---|---|
doc_id | UUID | Yes | ID of the document to delete |
Resources
MCP resources provide read-only data that agents can pull into their context:| Resource | URI | Description |
|---|---|---|
| User Profile | membase://profile | User settings payload (display_name, role, interests, instructions, timezone) |
| Recent Memories | membase://recent | Top 10 recent memories, ordered by event time when available and capture time otherwise |
Prompts
MCP prompts inject pre-built instructions and context into the agent’s system prompt:| Prompt | Description |
|---|---|
| start | Teaches the agent when to use search_memory, when to use resources, when to save memory, and what to avoid storing. |
start prompt can be used at session start to provide:
- Workflow guidance for memory retrieval and memory write behavior
- Safety guidance for secrets and transient information
- Resource usage guidance for profile versus recent timeline reads
Recommended Agent Behavior
Use these patterns for best results:- For user questions, call both
search_memoryandsearch_wikiand combine results: memory returns personal context, wiki returns factual knowledge. - For stable user profile context, read
membase://profile. - For latest updates or “what changed” questions, read
membase://recent. - For date-filtered searches, call
get_current_dateand then pass explicit date filters tosearch_memory. - Save durable user context with
add_memory, and skip secrets or one-off transient data unless explicitly requested. - Save factual, reference-style knowledge with
add_wiki(documentation, specs, stable notes). Do not useadd_wikifor personal preferences or habits.
Connection Setup
For detailed setup instructions for each agent, see the Agents guide.Cursor
One-click install
Claude Code
Plugin recommended
Claude
Custom connector
ChatGPT
Manual config
Next Steps
Memory
Explore and manage memories.
Knowledge Wiki
Deep dive on wiki documents, collections, imports, and search.
Chat in Dashboard
Talk to your knowledge base without an external agent.