io.github.romainsantoli-web/memory-os-ai

memory-os-ai

Adaptive memory for AI agents — FAISS search, chat extraction, cross-project linking

1 21 tools GitHub PyPI

No known CVEs

No license

Maintained

Last commit 76d ago

Works with most clients

Transport: stdio, sse, http

21 tools · ~878 tok

Grade B · 0.4% of 200K ctx

Edit this pageView history

AI / ML

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "io-github-romainsantoli-web-memory-os-ai": {
      "args": [
        "memory-os-ai"
      ],
      "command": "uvx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-romainsantoli-web-memory-os-ai)](https://mcppedia.org/s/io-github-romainsantoli-web-memory-os-ai)

Read me

What io.github.romainsantoli-web/memory-os-ai does

Adaptive memory system for AI agents — universal MCP server for Claude Code, Codex CLI, VS Code Copilot, ChatGPT, and any MCP-compatible client.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'memory-os-ai' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

78/100across 5 weighted dimensions

How we score →

0255075100

−22

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked memory-os-ai against OSV.dev.

Inventory

Tools (21)

Click any tool to inspect its schema.

~878 tokens total

Inventory

Resources (3)

memory_documents

Indexed documents

memory://documents/*

memory_logs_conversation

Conversation logs

memory://logs/conversation

memory_linked_projects

Linked project memories

memory://linked/*

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.romainsantoli-web/memory-os-ai safe to use?: io.github.romainsantoli-web/memory-os-ai has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.romainsantoli-web/memory-os-ai?: io.github.romainsantoli-web/memory-os-ai supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.romainsantoli-web/memory-os-ai do?: io.github.romainsantoli-web/memory-os-ai provides 21 tools: memory_ingest, memory_search, memory_search_occurrences, memory_get_context, memory_list_documents and 16 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.romainsantoli-web/memory-os-ai?: io.github.romainsantoli-web/memory-os-ai is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is io.github.romainsantoli-web/memory-os-ai actively maintained?: io.github.romainsantoli-web/memory-os-ai is recently maintained — last commit was 76 days ago. It has 1 GitHub stars.

Similar servers

Others in ai-ml

View all →

Memory MCP Server98

Persistent memory using a knowledge graph

85.9k 5

Context Mode95

Privacy-first. MCP is the protocol for tool access. We're the virtualization layer for context.

15.1k 6

Gemini Cli95

An open-source AI agent that brings the power of Gemini directly into your terminal.

104.3k 8

Antigravity Workspace Template94

Workspace template + MCP server for Claude Code, Codex CLI, Cursor & Windsurf. Multi-agent knowledge engine (ag-refresh / ag-ask) that turns any codebase into a queryable AI assistant.

1.2k 2

MCP Security Weekly

Get CVE alerts and security updates for io.github.romainsantoli-web/memory-os-ai and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Concept

Memory OS AI transforms your local documents (PDF, DOCX, images, audio) into a semantic memory queryable by any AI model through the MCP (Model Context Protocol).

┌──────────────────────────────────┐ │ AI Client (any MCP-compatible) │ │ Claude Code / Codex / Copilot │ │ ChatGPT / custom agents │ ├──────────────────────────────────┤ │ MCP Protocol │ │ stdio / SSE / Streamable HTTP │ ├──────────────────────────────────┤ │ Memory OS AI Server │ │ ┌────────┐ ┌───────────────┐ │ │ │ FAISS │ │ Chat Extractor│ │ │ │ Index │ │ (4 sources) │ │ │ └────────┘ └───────────────┘ │ │ ┌────────────────────────────┐ │ │ │ Cross-Project Linking │ │ │ └────────────────────────────┘ │ └──────────────────────────────────┘

Features

21 MCP tools for memory management, search, chat persistence, project linking, and cloud storage

Semantic search with FAISS + SentenceTransformers (all-MiniLM-L6-v2)

Multi-format ingestion: PDF, DOCX, TXT, images (OCR), audio (Whisper), PPTX

Chat extraction: auto-detects Claude, ChatGPT, Copilot, and terminal history

Cross-project linking: share memory across multiple workspaces

Cloud storage overflow: auto-backup to Google Drive, iCloud, Dropbox, OneDrive, S3, Azure, Box, B2

3 transports: stdio (default), SSE (--sse), Streamable HTTP (--http)

MCP Resources: memory://documents/*, memory://logs/conversation, memory://linked/*

Local-first: all data on your machine by default, cloud only when disk runs low

21 MCP Tools

Tool	Description
`memory_ingest`	Index a folder of documents into FAISS
`memory_search`	Semantic search across all indexed content
`memory_search_occurrences`	Count keyword occurrences across documents
`memory_get_context`	Get relevant context for the current task
`memory_list_documents`	List all indexed documents with stats
`memory_transcribe`	Transcribe audio files (Whisper)
`memory_status`	Engine status (index size, model, device)
`memory_compact`	Compact/deduplicate the FAISS index
`memory_chat_sync`	Sync messages from configured chat sources
`memory_chat_source_add`	Add a chat source (Claude, ChatGPT, etc.)
`memory_chat_source_remove`	Remove a chat source
`memory_chat_status`	Status of all chat sources
`memory_chat_auto_detect`	Auto-detect chat workspaces on disk
`memory_session_brief`	Full memory briefing for session start
`memory_chat_save`	Persist conversation messages to memory
`memory_project_link`	Link another project's memory
`memory_project_unlink`	Unlink a project
`memory_project_list`	List all linked projects
`memory_cloud_configure`	Configure cloud storage backend for overflow
`memory_cloud_status`	Show local disk + cloud storage status
`memory_cloud_sync`	Push/pull/auto-sync between local and cloud

Tool

Description

memory_ingest

Index a folder of documents into FAISS

memory_search

Semantic search across all indexed content

memory_search_occurrences

Count keyword occurrences across documents

memory_get_context

Get relevant context for the current task

memory_list_documents

List all indexed documents with stats

memory_transcribe

Transcribe audio files (Whisper)

memory_status

Engine status (index size, model, device)

memory_compact

Compact/deduplicate the FAISS index

memory_chat_sync

Sync messages from configured chat sources

memory_chat_source_add

Add a chat source (Claude, ChatGPT, etc.)

memory_chat_source_remove

Remove a chat source

memory_chat_status

Status of all chat sources

memory_chat_auto_detect

Auto-detect chat workspaces on disk

memory_session_brief

Full memory briefing for session start

memory_chat_save

Persist conversation messages to memory

memory_project_link

Link another project's memory

memory_project_unlink

Unlink a project

memory_project_list

List all linked projects

memory_cloud_configure

Configure cloud storage backend for overflow

memory_cloud_status

Show local disk + cloud storage status

memory_cloud_sync

Push/pull/auto-sync between local and cloud

# macOS brew install tesseract ffmpeg antiword # Ubuntu/Debian sudo apt-get install tesseract-ocr ffmpeg antiw ... [View full README on GitHub](https://github.com/romainsantoli-web/Memory-os-ai#readme)

Frequently Asked Questions

Is io.github.romainsantoli-web/memory-os-ai safe to use?

io.github.romainsantoli-web/memory-os-ai has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.romainsantoli-web/memory-os-ai?

io.github.romainsantoli-web/memory-os-ai supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.romainsantoli-web/memory-os-ai do?

io.github.romainsantoli-web/memory-os-ai provides 21 tools: memory_ingest, memory_search, memory_search_occurrences, memory_get_context, memory_list_documents and 16 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.romainsantoli-web/memory-os-ai?

io.github.romainsantoli-web/memory-os-ai is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is io.github.romainsantoli-web/memory-os-ai actively maintained?

io.github.romainsantoli-web/memory-os-ai is recently maintained — last commit was 76 days ago. It has 1 GitHub stars.