Schema set: Research & reading notes

[CheMiguel23]

Keep track of what you read and learn: books, papers and videos, their authors, the concepts they cover, and your own notes, all linked together.

What you can say to Claude

• "Add 'Thinking, Fast and Slow' by Daniel Kahneman. I finished it, 5/5."
• "Note from chapter 1: most everyday judgements come from System 1."
• "What have I read about System 1? Which sources cover it?"
• "Which books on my list haven't I started yet?"

Tools you get

Each schema creates three tools: add_…, update_… and delete_….

Tool	Required fields	Links it creates
add_author	name	–
add_concept	name	relatedTo → related_to
add_note	name, content	source → from, concepts → about
add_source	name	authors → written_by, topics → covers

Setup

1. Create a folder for this set, for example research-schemas, anywhere on your computer.

2. Save each file below into that folder, keeping the file names.

3. Point MemoryMesh at the folder with the MEMORYMESH_SCHEMAS_DIR environment variable in your Claude Desktop config:

   "memorymesh": {
     "command": "node",
     "args": ["C:\\path\\to\\MemoryMesh\\dist\\index.js"],
     "env": {
       "MEMORYMESH_SCHEMAS_DIR": "C:\\path\\to\\research-schemas",
       "MEMORYMESH_MEMORY_FILE": "C:\\path\\to\\research-schemas\\memory.json"
     }
   }

   On macOS use normal paths, e.g. "/Users/you/research-schemas". Setting MEMORYMESH_MEMORY_FILE too is optional; it keeps this set's data separate from your other memories.

4. Fully quit and restart Claude Desktop.

Using your own folder keeps these schemas safe from updates and keeps the built-in examples out of your tool list. (You can also drop the files into dist/data/schemas instead.)

Tips

• Linked items must exist first. Claude handles this itself: if it links to something missing, the call fails with an explanation and nothing is saved, so it creates the missing item and tries again.
• Only name (and occasionally one more field) is required, so Claude doesn't have to invent values it doesn't know.
• Extra details are welcome. Fields not listed in a schema are saved as notes on the item.
• Make it yours. Rename fields, add your own, or remove what you don't need. The SchemaManager can help.

The 4 schema files

author.schema.json

{
  "name": "add_author",
  "description": "Add an author or researcher to the knowledge graph",
  "properties": {
    "name": {
      "type": "string",
      "description": "The author's name",
      "required": true
    },
    "field": {
      "type": "string",
      "description": "Field or area of work"
    },
    "affiliation": {
      "type": "string",
      "description": "University, company or organization"
    },
    "notes": {
      "type": "string",
      "description": "Anything else worth remembering"
    }
  },
  "additionalProperties": true
}

concept.schema.json

{
  "name": "add_concept",
  "description": "Add a concept, idea or topic to the knowledge graph",
  "properties": {
    "name": {
      "type": "string",
      "description": "The concept's name",
      "required": true
    },
    "definition": {
      "type": "string",
      "description": "What it means, in your own words"
    },
    "field": {
      "type": "string",
      "description": "Field it belongs to"
    },
    "relatedTo": {
      "type": "array",
      "description": "Other concepts this one is connected to",
      "relationship": {
        "edgeType": "related_to",
        "description": "Other concepts this one is connected to (must already exist)"
      }
    }
  },
  "additionalProperties": true
}

note.schema.json

{
  "name": "add_note",
  "description": "Add a note: a quote, insight or idea, linked to where it came from",
  "properties": {
    "name": {
      "type": "string",
      "description": "A short unique title for the note",
      "required": true
    },
    "content": {
      "type": "string",
      "description": "The note itself",
      "required": true
    },
    "source": {
      "type": "string",
      "description": "The source this note came from",
      "relationship": {
        "edgeType": "from",
        "description": "The source this note came from (must already exist)"
      }
    },
    "concepts": {
      "type": "array",
      "description": "Concepts this note is about",
      "relationship": {
        "edgeType": "about",
        "description": "Concepts this note is about (must already exist)"
      }
    },
    "location": {
      "type": "string",
      "description": "Page, chapter or timestamp in the source"
    }
  },
  "additionalProperties": true
}

source.schema.json

{
  "name": "add_source",
  "description": "Add a source (book, paper, article, video...) to the knowledge graph",
  "properties": {
    "name": {
      "type": "string",
      "description": "The title",
      "required": true
    },
    "type": {
      "type": "string",
      "description": "Kind of source",
      "enum": [
        "book",
        "paper",
        "article",
        "video",
        "podcast",
        "course",
        "other"
      ]
    },
    "authors": {
      "type": "array",
      "description": "Authors of the source",
      "relationship": {
        "edgeType": "written_by",
        "description": "Authors of the source (must already exist)"
      }
    },
    "year": {
      "type": "string",
      "description": "Year of publication"
    },
    "url": {
      "type": "string",
      "description": "Link to the source"
    },
    "status": {
      "type": "string",
      "description": "Reading status",
      "enum": [
        "to read",
        "reading",
        "finished",
        "abandoned"
      ]
    },
    "rating": {
      "type": "string",
      "description": "Your rating, e.g. '4/5'"
    },
    "summary": {
      "type": "string",
      "description": "Short summary in your own words"
    },
    "topics": {
      "type": "array",
      "description": "Concepts this source covers",
      "relationship": {
        "edgeType": "covers",
        "description": "Concepts this source covers (must already exist)"
      }
    }
  },
  "additionalProperties": true
}