pixell-global avatar

sayou

pixell-global/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 tools

Public 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.

License Python

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

View the full README on GitHub

Details

Repository
github.com/pixell-global/sayou
Categories
Documents & Knowledge, Search & Web Crawling
Package
sayou
Transport
STDIO
Registry
MCP registry, active

Related Documents & Knowledge MCP servers

View all
1cdnsteve avatarRemembrallMCPcdnsteve/remembrallmcpPersistent knowledge memory for AI agents. Hybrid search, code graph, pgvector.24stars
2yantrikos avatarYantrikdb Mcpyantrikos/yantrikdb-mcpCognitive memory for AI agents — semantic recall, knowledge graph, and contradiction detection24stars
3heubme2020 avatarDataSinkingheubme2020/datasinkingFull-text financial reports (US, China, Japan, Korea, Taiwan, UK) as clean Markdown for RAG agents.22stars
4jghiringhelli avatarCodeseekerjghiringhelli/codeseekerGraph-powered code intelligence with semantic search and knowledge graph for AI assistants21stars
5muvon avatarOctobrainmuvon/octobrainPersistent memory for AI assistants with semantic search and knowledge graph relationships.20stars
6elsahafy avatarUx Mcp Serverelsahafy/ux-mcp-serverUX toolkit: 28 knowledge resources, 23 analysis tools & 4 workflow prompts for any MCP client0stars