list_notes
List Notes. List your notes, optionally filtered by status or tag.
| Group | Access | MCP name |
|---|---|---|
| Notes | Read-only | list_notes |
Description
The description the MCP server sends to the model, word for word. Its rules apply to every call.
List your notes, optionally filtered by status or tag. Status evergreen is the source notes set to repeat; it is not a tag. Use skip for pagination. Check hasMore in the response to know if more results exist.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max notes to return (default 20, max 50) Default 20. |
skip | number | No | Offset for pagination Default 0. |
status | string | No | Filter by note status. evergreen means source notes set to repeat. It is a status, not a tag. One of: "draft", "ready", "scheduled", "published", "evergreen". |
tag | string | No | Filter by category/tag name |
Example call
The smallest valid request: required arguments only, with placeholder values.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_notes",
"arguments": {}
}
}Result
The result has structuredContent that matches this schema. The same data is also in content as JSON text.
| Field | Type | Required | Description |
|---|---|---|---|
count | number | Yes | |
hasMore | boolean | Yes | |
notes | object[] | Yes | |
notes[].autoRestackAfterHours | number | null | Yes | |
notes[].content | string | Yes | |
notes[].createdAt | string | Yes | Format date-time. |
notes[].id | string | Yes | |
notes[].scheduledAt | string | null | Yes | |
notes[].status | string | Yes | |
notes[].tags | string[] | Yes | |
notes[].updatedAt | string | Yes | Format date-time. |
skip | number | Yes | |
total | number | Yes |
Annotations
| Hint | Value |
|---|---|
readOnlyHint | true |
destructiveHint | false |
openWorldHint | false |
The full input and output JSON Schemas for every tool are in /mcp-tools.json.
All MCP tools
Every tool the WriteStack MCP server exposes (29 in total), grouped by area, with what each does and whether it changes data.
get_note
Get Note. Get a single note by ID with its full content, including auto-restack configuration (autoRestackAfterHours), Buffer cross-post channels (bufferChannelIds), and any per-channel Buffer post overrides (bufferChannelPosts: custom text and attachments for a channel).