sayou

MCP.Pizza Chef: pixell-global

Sayou creates a persistent workspace for your AI assistant by storing notes, research, and data as versioned files that last beyond a single chat. It works with apps like Claude Code, Cursor, and Windsurf, letting your AI read, write, search, and track changes in your workspace. You install it with pip and configure your MCP client. Sayou helps your AI remember and build knowledge over time, not just forget after each session.

Files/PDF
Notes
Other

Use This MCP server To

Save and update notes that persist across AI sessions Search my saved workspace files by keywords or tags View version history and diffs of my notes Store and retrieve key-value settings with optional expiration List all files and folders in my AI workspace Read large files with summarized context and pointers Find files matching patterns or containing specific words

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

Or from the terminal:

claude plugin install sayou@pixell-global

One 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 --claude

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

sayou FAQ

Can I use this to save and recall notes across AI sessions?
Yes — sayou stores your notes as versioned files that your AI can read and update anytime, even across sessions.
Can I use this to search my workspace for specific topics?
Yes — you can search file contents and metadata to quickly find relevant information saved in your workspace.
Which apps support sayou?
It works with MCP-compatible clients like Claude Code, Cursor, and Windsurf.
Do I need an API key or account to use sayou?
No account is required for local use, but syncing with Sayou Drive needs an API key.
How hard is it to set up sayou?
Setup is developer-level; you install it via pip and configure your MCP client with a snippet.
Can I see the history of changes to my files?
Yes — every change is versioned and you can view diffs between versions.
Does sayou overwrite my files when I save updates?
No — it keeps every version, so nothing is lost and you can time-travel through changes.