sayou
A persistent knowledge workspace that gives Claude 11 MCP tools for versioned file storage, search, and retrieval. It treats context like a file system instead of a database: every write creates a new version with YAML frontmatter for metadata, reads respect token budgets and return summaries when needed, and searches work across both content and frontmatter fields. You get workspace_write, workspace_read, workspace_search, and workspace_history for version diffs, plus glob patterns, grep, and a key-value store with TTL support. Installs via pip with auto-configuration for Claude Code, Cursor, or Windsurf. Optional cloud sync through Sayou Drive. Reach for this when you need Claude to remember research, decisions, or structured notes across sessions without everything living in chat history.
- GitHub stars
- 27
- tools
- 12
- transport
- STDIO
- last updated
- Feb 22, 2026
Tools
12 toolsPublic tool metadata for what this MCP can expose to an agent.
workspace_writeWrite or update a file (text or binary with YAML frontmatter)
Write or update a file (text or binary with YAML frontmatter)
No parameter schema in public metadata yet.
workspace_readRead latest or specific version, with optional line range
Read latest or specific version, with optional line range
No parameter schema in public metadata yet.
workspace_listList files and subfolders with auto-generated index
List files and subfolders with auto-generated index
No parameter schema in public metadata yet.
workspace_searchSearch by full-text query, frontmatter filters, or chunk-level
Search by full-text query, frontmatter filters, or chunk-level
No parameter schema in public metadata yet.
workspace_deleteSoft-delete a file (history preserved)
Soft-delete a file (history preserved)
No parameter schema in public metadata yet.
workspace_historyVersion history with timestamps, or diff between two versions
Version history with timestamps, or diff between two versions
No parameter schema in public metadata yet.
workspace_globFind files matching a glob pattern
Find files matching a glob pattern
No parameter schema in public metadata yet.
workspace_grepSearch file contents with context lines
Search file contents with context lines
No parameter schema in public metadata yet.
workspace_kvKey-value store (get/set/list/delete with optional TTL)
Key-value store (get/set/list/delete with optional TTL)
No parameter schema in public metadata yet.
workspace_linksFile links and knowledge graph (get or add links)
File links and knowledge graph (get or add links)
No parameter schema in public metadata yet.
workspace_chunksChunk outline or read a specific chunk by index
Chunk outline or read a specific chunk by index
No parameter schema in public metadata yet.
workspace_semantic_searchVector similarity search (requires SAYOU_EMBEDDING_PROVIDER)
Vector similarity search (requires SAYOU_EMBEDDING_PROVIDER)
No parameter schema in public metadata yet.
Sponsors
Readme
sayou
A file-system inspired context store for AI agents.
Built to replace the databases of the web era. Open source. File-first. SQL-compatible.
Databases were designed for transactions — they reduce nuance to fit a schema. Agents think deeply, then forget everything when the session ends. sayou is where reasoning persists, context accumulates, and knowledge compounds over time.
- Files that hold what databases can't — Frontmatter for structure. Markdown for context. Versioned. Auditable.
- One read. Full context. — Every read accepts a
token_budget. Returns summaries with section pointers when content exceeds the budget. - Knowledge that compounds — Append-only version history. Every change is a new version. Full audit trail and time-travel reads.
- Any agent can connect — MCP server, Python library, or CLI. Optional REST API with
pip install sayou[api].
Quick Start
Claude Code (recommended)
From within Claude Code:
/plugin install sayou@pixell-global
Details
- Repository
- github.com/pixell-global/sayou
- Categories
- Documents & Knowledge, Search & Web Crawling
- Package
sayou- Transport
- STDIO
- Registry
- MCP registry, active