notes_save
ActiveTool of io.github.saloprj/dialogbrain
declared in 1.17.0
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.
Parameters schema
{
"type": "object",
"required": [
"key",
"value",
"scope"
],
"properties": {
"key": {
"type": "string",
"description": "Short identifier for this note (must not start with '__' — reserved)"
},
"scope": {
"enum": [
"workspace",
"agent",
"thread",
"person",
"global"
],
"type": "string",
"description": "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": {
"type": "string",
"description": "The note content"
},
"pinned": {
"type": "boolean",
"description": "Pin this note so it's always loaded first. Default false."
},
"scope_ref_id": {
"type": "string",
"description": "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": {
"type": "integer",
"description": "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": {
"type": "integer",
"description": "Auto-delete after N hours. Omit for permanent notes."
}
}
}Parent server
io.github.saloprj/dialogbrain
https://github.com/saloprj/dialogbrain-mcp
1/7 registries