sayou MCP server
io.github.pixell-global/sayou·v0.2.2·28 starsPersistent knowledge workspace for AI agents. Versioned files, search, and MCP tools.
28 stars26 downloads/wk
Reviews
Write oneNobody has reviewed sayou yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
sayou tools (12, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
workspace_chunksGet chunk outline for a file: headings, line ranges, token estimates. Pass chunk_index to read a specific chunk's content.
workspace_deletewrite actionDelete a file from the workspace (soft-delete). The file's version history is preserved.
workspace_globFind files matching a glob pattern. Supports: ** (any path depth), * (any name), ? (single char). Examples: **/*.md, research/**, clients/*/profile.md
workspace_grepSearch file contents for a text query. Returns matching lines with surrounding context. Optionally filter by glob path_pattern (e.g., **/*.md). Like grep but for workspace files.
workspace_historyGet version history for a file. Returns all versions with timestamps, sizes, and content hashes. Pass version_a and version_b to compare two versions — returns a unified diff showing additions (+) and removals (-).
workspace_kvKey-value store for configuration, caches, and temporary data. Actions: get (retrieve by key), set (store value with optional TTL), list (browse keys by prefix), delete (remove key). Values are stored as JSON strings.
workspace_linksGet outgoing and incoming links for a file. To add a link, pass add_target with the target file path. Link types: reference, parent, depends_on, related, supersedes.
workspace_listList files and subfolders in a workspace folder. Returns an auto-generated index table with frontmatter columns.
workspace_readRead a file from the workspace. Returns the latest version content with frontmatter metadata. Use token_budget to control output size. Optionally specify a version number to read a specific historical version. Use line_start/line_end to read a specific line range (1-indexed, inclusive) — useful after reading a summarized file to drill into specific sections.
workspace_searchSearch files by frontmatter metadata filters and/or full-text query. Filters match exact frontmatter values. Query searches file paths and frontmatter text. Set chunk_level=true for section-level precision instead of whole-file matches.
workspace_semantic_searchSearch files by meaning using vector embeddings. Returns the most similar files ranked by relevance. Best for finding conceptually related content when you don't know exact keywords.
workspace_writewrite actionWrite a file to the workspace. Creates the file if it doesn't exist, or creates a new version if it does. Content can include YAML frontmatter for structured metadata. For binary files, pass base64-encoded content and set content_type (e.g., image/png).
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan77 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 146 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Findings (1)
- mediumsubprocess with shell=True
exec.shell-truesayou-0.2.2/agent/sandbox/manager.py: …esult = subprocess.run({repr(command)}, shell=True, capture_output=True, text=True, timeou…
How sayou compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 75/100
- higher than 45% of 3,470 Web search servers
- Tools
- 12
- the typical Web search server has 5
- Tools that change things
- 17%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 28
- more than 90% of 1,786 Web search servers
- Downloads a week
- 26
- more than 12% of 827 Web search servers with a package
What its tools let an agent do: 10 read · 2 change
Install sayou in Claude Code, Cursor or VS Code
claude mcp add sayou -- uvx sayou
What the publisher says
From the sayou repository's README, as published. We do not edit it. Read it on GitHub
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-globalOr from the terminal:
claude plugin install sayou@pixell-globalOne command. This installs the plugin with lifecycle hooks (workspace context on session start, passive activity capture, session summaries) and skills (/ws, /save, /recall). If sayou isn't installed yet, the plugin auto-installs it on first run.
Cloud mode: To sync your workspace via Sayou Drive, run sayou auth after installing and paste your API key from Settings.
pip install
pip install sayou && sayou init --claudeThis installs sayou and configures ~/.claude/mcp.json. You get the 11 MCP tools but no hooks or skills. You can also use --cursor or --windsurf, or run sayou init without flags to get the config snippet to paste manually.
To verify either method, run sayou status — you should see your workspace path, database location, and 11 tools registered. If you see errors, jump to Troubleshooting.
Try It
Open Claude Code and paste any of these prompts. Each one triggers a different MCP tool — no setup beyond the Quick Start above.
Every write creates a new version. Nothing is overwritten. You can always go back.
What It Looks Like
A short conversation showing sayou in action across sessions:
You: Research competitor pricing for our enterprise tier and save your findings.
Claude Code: I'll research this and save my findings to the workspace.
[Uses workspacewrite to create research/competitor-pricing.md]*
Saved to research/competitor-pricing.md with frontmatter:
status: draft, topic: competitor-pricing
You (next day, new session): What did we learn about competitor pricing?
Claude Code: Let me check our workspace.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
sayou: common questions
- Is sayou MCP server safe?
- Mostly: it is graded B (75/100). Read the sayou safety report
- How do I install sayou?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does sayou need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is sayou maintained?
- The last commit was 183 days ago (2026-05-05). The latest release is v0.2.2.
- What can I use instead of sayou?
- Servers from other publishers that do the same job: Octobrain MCP server, Repomix MCP server and DocsMint MCP server.
- How does sayou compare with other Web search MCP servers?
- safety score 75/100 (higher than 45% of 3,470 Web search servers); tools 12 (the typical Web search server has 5); tools that change things 17% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to sayou
Same job from other publishers: the closest match first, then the best rated.
- OctobrainPersistent memory for AI assistants with semantic search and knowledge graph relationships.not reviewedGrowingA
- RepomixPack local or remote codebases into AI-friendly files that LLMs and coding agents can read or searchnot reviewedWidely usedA
DocsMintCloud or self-hosted knowledge for AI agents: hybrid search, reranking, GraphRAG, scoped MCP tools.not reviewedEstablishedA- Sui Knowledge Base (kapa.ai)Semantic search across Sui documentation and knowledge sources, powered by kapa.ainot reviewedEstablishedA
- ThoughtDAGSearch local AI conversations by file or phrase and recall source turns. Four read-only tools.not reviewedEstablishedA