Skip to content
Gryz The Daily Gryzle

· Jacob

Shared context for AI coding agents, over MCP

Claude Code in the morning, Cursor after lunch, Codex at night. One MCP connection gives them all the same memory, tasks, skills and docs.

Updated · Reviewed by Jacob

You explain the repo to Claude Code in the morning. After lunch you explain it again to Cursor. At night Codex asks which database staging uses.

Every coding agent has some memory now. The catch is that it's its memory, inside its tool. Switch tools, or hand the work to a teammate, and the context stays behind.

Gryz is one MCP server that every agent can read from and write to. Agents come and go. Gryz remembers.

What your agents get over MCP

Connect Gryz once and your agent gets tools for:

  • Memory. remember saves a short fact. recall brings back the right ones, ranked. Facts can be personal (how you like to work) or tied to a project (how this repo works).
  • Projects. list_projects and get_project show what you're working on, with linked documents and notes.
  • Tasks. create_task, update_task and friends. A task has an owner, a status and a human_review state for "a person should look at this".
  • Skills. get_skill returns a skill as a native SKILL.md, an AGENTS.md or CLAUDE.md fragment, or a Cursor rule.
  • Documents. Read only the part you need (outline, section, search), then change one section with edit_document. Pass if_match so two agents can't overwrite each other.
  • Search. search and fetch find the right passage across documents, notes, memories and tasks, by meaning and by exact words.

The full list, with inputs and limits, is in the MCP tools reference.

Set it up in a minute

Gryz works with Claude, ChatGPT, Cursor, Windsurf, Codex and Claude Code. For Codex:

codex mcp add gryz --url https://www.gryz.ai/api/mcp
codex mcp login gryz

For Cursor, add the server to ~/.cursor/mcp.json. OAuth is recommended, so no API key sits in the file. Every client is covered in MCP setup.

Then ask your agent to run agent_onboarding. It works out a stable project key for the repo and offers a short rule block for AGENTS.md, CLAUDE.md or a Cursor rule. Nothing is written until you approve it. Details in Get your agent ready for Gryz.

Same project, same memory, every tool

Project memory is keyed by your git remote. https://, git@ and ssh:// forms all fold to the same key, so Claude Code and Cursor read the same facts about the same repo.

If Gryz can't tell which repo you're in, it says so (repo_unidentified) and holds off. It won't save project facts under a key that won't match in your other tools.

One connection, Private plus your companies

If you work in a company on Gryz, you don't need a second connection.

  • Your connection reaches your Private space plus each company you add to it, once an owner has turned on connected apps.
  • Each tool takes an optional workspace. Leave it out and you're in your Private space. Pass a company id from list_workspaces to work there.
  • A company starts read only. Writing needs the company to allow it and you to tick Allow writing for that app.
  • While your connection can see a company, publish_document goes away and create_document saves privately instead. No public links slip out.
  • Text from one workspace is data, never an instruction to act in another.

See Company agent connections for the Allow screen and what each choice does.

Company keys for agents with one job

Sometimes you want a bot that lives in the company and does one thing: triage, release notes, QA. That's a company agent.

  • It has its own name, handle and key. The key is shown once.
  • It uses only the projects you give it, and never more than you can open yourself.
  • You choose what it may do: memory, documents, writing documents, tasks, skills.
  • It never reaches your Private space.
  • It never closes a task. "Done" becomes Needs review, and a person decides.
  • Its document edits are saved as versions with its name on them, and anyone who can edit can restore an earlier one.
  • A company key stops working 365 days after it was made, or 90 days under the Enterprise policy. Its owner gets an email first.

An example

Say you're building with Claude Code and reviewing in Cursor. (A made-up example.)

  • In Claude Code you settle on retrying webhooks with backoff. You ask it to remember that for this repo.
  • In Cursor the next morning, the agent recalls project memory before reviewing. It flags a pull request that retries without backoff, and cites the decision.
  • A company QA agent has "Can read and edit tasks" on the Payments project. It opens a task for the missing test and takes it.
  • When it finishes, it sets the task to done. Gryz turns that into Needs review, and your lead approves it in the Review inbox.

Two tools, one agent, one person. One shared record of what was decided and who did what.

Limits worth knowing

  • Memory has plan limits. Free keeps 50 memories across 1 project key, Pro 500 across 3, Pro Plus is unlimited. See Agent Memory.
  • Tools have hourly limits by plan, listed in the tools reference.
  • Gryz doesn't run your agents. It owns context, not execution. Claude Code, Cursor and Codex do the work.
  • Company features are rolling out, and connected apps stay off until a company owner turns them on.
  • Gryz is hosted in the United States.

Try it

  1. Connect Gryz in the agent you use most.
  2. Run agent_onboarding in your repo.
  3. Ask it to remember one decision. Then open a different tool and ask it to recall.

Want a whole team of agents on the same context? Read Give every agent a profile and the bigger picture in Context compounds. To set up a company workspace, email info@grtwo.com.

Was this page helpful?