Connect Gryz MCP and use list_notes, create_note, append_note, update_note, and delete_note — with example prompts, access modes, and rate limits.

Before you start

A Gryz account (free tier includes MCP and one Note; Pro includes unlimited Notes)
MCP connected — follow Connect Gryz MCP in Cursor if you have not already
Server URL: https://www.gryz.ai/api/mcp/ (always use www and a trailing slash)

Notes MCP tools

Tool	Purpose
`list_notes`	Search and list Notes (titles, previews, IDs, origin, AI access mode)
`create_note`	Create a new private Markdown Note
`append_note`	Add text to the end (preferred for logs and running lists)
`update_note`	Replace title and/or content
`delete_note`	Soft-delete a Note

Note IDs are UUIDs. Always list_notes first if you need to target a specific Note by ID.

Optional list_notes filters:

q — case-insensitive search in title and body
source — me (web-authored), agent (any client), or an exact client name

Full input tables: MCP tools reference.

Example prompts

Create and append

Create a Gryz note titled "Sprint backlog" with this markdown:
- Ship Notes docs
- Fix publish modal copy

Append to my Gryz note "Sprint backlog":
- Review MCP rate limits

List and search previews

List my Gryz notes updated in the last week

Search my Gryz notes for "onboarding" and show titles and previews

Update and delete

Update Gryz note <uuid> — replace the content with the markdown I paste next

Delete Gryz note <uuid>

list_notes can search every live Note and returns its title plus a content preview. Gryz does not currently expose a get_note tool for retrieving a Note's complete body. Mutations to an existing Note (append_note, update_note, and delete_note) fail when that Note is read-only for AI; creating a separate Note is unaffected.

Enable editing in the web app:

Open the Note at /my-docs/notes/[id]/
Check Let AI assistants edit this note in the footer
Retry the MCP call

New Notes created through MCP are editable by MCP by default unless you change access in the web UI afterward.

Notes vs `publish_document`

Goal	Tool
Private draft or agent scratch pad	`create_note` / `append_note`
Shareable link for others	`publish_document`

publish_document creates a document with visibility public or restricted. It does not convert a Note, and list_notes returns only a preview rather than the complete Note body. To publish an existing Note accurately, use Publish as document in My Docs — see Manage Notes in My Docs.

Rate limits (hourly, per tool)

Limits roll in a one-hour window and vary by plan:

Tool group	Free (Starter)	Pro	Pro Plus
List Notes	120	240	480
Create Note	20	120	240
Update / append Note	40	180	360
Delete Note	20	60	120

If you hit a limit, wait for the window to roll or reduce automation frequency. Errors name the tool and retry guidance.

Troubleshooting

Issue	Fix
Notes tools missing	Confirm OAuth completed; restart the MCP client; verify `documents` scope
`create_note` quota error	Free tier allows one live Note — delete or upgrade
Append/update/delete failed	Note may be read-only for AI — enable collaboration in the web editor
Wrong Note updated	Use `list_notes` to copy the correct UUID
Need a public URL	Use `publish_document`, not `create_note`

Reference

Getting started with Notes — concepts and quotas
Notes overview (reference) — deletion retention and concurrency
MCP setup (reference) — ChatGPT, Claude, and API key auth

Use Notes with MCP