Getting started with Notes
What Gryz Notes are, how they differ from published documents, plan limits, and when to use Notes in the web app or through MCP.
Updated · Reviewed by Jacob
What are Gryz Notes?
Notes are private Markdown files tied to your Gryz account. They live in My Docs → Notes (/my-docs/notes/) and never get a public URL on their own.
Use Notes when you need:
- A scratch pad or running log while you work
- Context your AI assistant can read and update over time
- A draft you might publish later as a separate document
Notes vs published documents
| Note | Published document | |
|---|---|---|
| Visibility | Private to your account | Public, PIN, or restricted (invite-only) |
| URL | No share link | gryz.ai/d/... |
| Format | Markdown only | Markdown, HTML, SVG, JSON, CSV, Mermaid |
| MCP tools | list_notes, create_note, append_note, update_note, delete_note | publish_document, get_document, etc. |
| Sync after publish | Stays independent | Publishing from a Note creates a snapshot — edits do not sync |
When you are ready to share, use Publish as document on the Note. That creates a new document; the Note stays private. See Manage Notes in My Docs for the full publish flow.
Plan limits
| Tier | Notes |
|---|---|
| Anonymous | Not available |
| Free (Starter) | 1 live Note |
| Pro | Unlimited |
| Pro Plus | Unlimited |
If you are on the free tier and already have one Note, delete it before creating another. Publishing creates a separate document but keeps the source Note, so publishing alone does not free the Note slot. Pro and Pro Plus remove that cap.
Full tier context: Plan Comparison.
Two ways to work with Notes
In the web app
Create, search, edit, export, and delete Notes from My Docs → Notes. You control whether AI assistants can edit each Note with the Let AI assistants edit this note checkbox.
Walkthrough: Manage Notes in My Docs
Through MCP
After you connect Gryz MCP in Cursor, your assistant can list, create, append, update, and delete Notes — subject to each Note’s AI access setting.
Walkthrough: Use Notes with MCP
AI access modes
Every Note has one of two modes:
| Mode | You in the web app | AI assistant (MCP) |
|---|---|---|
| Collaborate (default when enabled) | Edit freely | Can append, update, or delete |
| Read-only for AI | Edit freely | Can list and read; mutations fail |
Toggle Let AI assistants edit this note in the editor footer. Use read-only when you want the assistant to reference a Note without changing it.
What to do next
- Manage Notes in My Docs — create your first Note, search, export, and publish as a document
- Use Notes with MCP — example prompts and tool behavior
- Notes overview (reference) — concise reference for quotas, deletion, and concurrency
Publish an SVG without an account
Paste or upload SVG on the gryz.ai homepage, preview it, and get a shareable public link as an anonymous visitor — no sign-in required.
Manage Notes in My Docs
Step-by-step guide to creating, searching, editing, exporting, and publishing Notes from the Gryz dashboard — including AI access and publish-as-document.