notes_save
Save a fact or note into the agent's memory. Use scope to choose visibility: 'workspace' = visible to every agent in this workspace (use for shared facts, project conventions); 'agent' = private to this agent (use for personal working notes); 'thread' = scoped to one conversation (use for thread-specific reminders); 'person' = scoped to one contact (use for per-contact context). If a note with the same key+scope exists it will be updated. Do NOT use this tool for behavioral rules or corrections — use feedback.save for those.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"key": "<key>",
"value": "<value>",
"scope": "<scope>"
},
"name": "notes_save"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | Short identifier for this note (must not start with '__' — reserved) | |
| scope | Yes | Scope of the note. 'workspace' = shared across all agents; 'agent' = private to this agent (was 'global' pre-PR1); 'thread' = per-conversation; 'person' = per-contact. 'global' is accepted as a deprecation alias for 'agent'. | |
| value | Yes | The note content | |
| pinned | No | Pin this note so it's always loaded first. Default false. | |
| memory_type | No | What kind of note: 'feedback' = a decision or correction by the owner or client (how to act), 'fact' = a durable fact about the client, their people or the business, 'context' (default) = anything else worth keeping. 'summary' and 'digest' are written by the system, 'procedural' is reserved. | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. | |
| scope_ref_id | No | Reference ID — thread_id (for scope=thread) or person_id (for scope=person). Required for thread/person scope. In MCP mode (no thread context), must be passed explicitly. | |
| target_agent_id | No | Target notebook. In agent mode optional (defaults to your own); required from MCP. Agents cannot target other agents' notebooks. Ignored when scope='workspace' (workspace memory is shared). | |
| expires_in_hours | No | Auto-delete after N hours. Omit for permanent notes. |