Skip to content

engram-app/engram

v1.0.0

AI memory made of plain markdown notes you can read and edit in Obsidian or the web app.

MCP servers

Declared configuration, as published in mcp.json. The directory shows indexed content; it never connects to or executes these servers.

engramstreamable-http
{
  "type": "streamable-http",
  "url": "https://mcp.engram.page"
}

What this package declares

The files a client reads when it loads this plugin, exactly as this revision carries them.

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "engram",
  "version": "1.0.0",
  "description": "AI memory made of plain markdown notes you can read and edit in Obsidian or the web app.",
  "author": {
    "name": "Engram",
    "email": "support@engram.page",
    "url": "https://engram.page"
  },
  "homepage": "https://engram.page",
  "repository": "https://github.com/engram-app/engram",
  "keywords": [
    "obsidian",
    "obsidian vault",
    "notes",
    "memory",
    "markdown",
    "knowledge base"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Engram AI Memory",
        "shortDescription": "AI memory you edit in Obsidian",
        "longDescription": "Engram is AI memory you can read and edit. What you save in one conversation is there to recall in the next.\n\nThat memory is plain markdown notes. The memory is the note itself, so you can read exactly what is remembered, and when something is wrong, you fix the line and the fix is what gets recalled.\n\nRead and edit your memory in Obsidian, where the Engram plugin syncs it in real time, in the Engram web app, or on your phone. It works with Obsidian closed.\n\nSearch combines keyword and semantic matching, so an exact string like an error message, a config key or an ID is findable, not just something similar. Notes are encrypted at rest with a per-user key. Sign-in is OAuth, and you can revoke access from your account.",
        "developerName": "Engram",
        "category": "Productivity",
        "capabilities": [
          "Search memory",
          "Read notes",
          "Create notes",
          "Edit and append to notes",
          "Organize folders"
        ],
        "websiteURL": "https://engram.page",
        "supportURL": "https://engram.page/support",
        "privacyPolicyURL": "https://engram.page/privacy",
        "termsOfServiceURL": "https://engram.page/terms",
        "defaultPrompt": [
          "Remember that our search API allows 60 requests per minute.",
          "What value did I set for POOL_SIZE in my deploy notes?",
          "Summarize everything my notes say about the Q3 launch plan."
        ],
        "brandColor": "#8B4FE8",
        "composerIcon": "./assets/icon.svg",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Answer a question from an existing note",
              "prompt": "Why is the website rebuild parked?",
              "tools_triggered": "search_notes",
              "expected_behavior": "Answers from '20 Projects/Website rebuild/Website rebuild - why it stays parked.md': every client came from referrals, the site produced zero enquiries, and Priya is needed for the Brightwell deadline. Parked until Q4; it unparks if Lampeter Foods goes ahead. Names the note as the source."
            },
            {
              "description": "Read a specific note",
              "prompt": "Open my playbook on estimating a project and list the steps of the method.",
              "tools_triggered": "search_notes, get_notes",
              "expected_behavior": "Reads '30 Playbooks/Estimating a project.md' and lists its six method steps as written, including adding 40 percent to discovery and converting at 2.75 delivery days per week."
            },
            {
              "description": "Create a new note",
              "prompt": "Save a note called Book Ideas in my 60 Reading folder with three science fiction book recommendations.",
              "tools_triggered": "create_note",
              "expected_behavior": "Creates '60 Reading/Book Ideas.md' containing three recommendations and reports the path it was saved to."
            },
            {
              "description": "Append to an existing note",
              "prompt": "Add 'Confirm the SSL certificate auto-renews' to the end of my website launch checklist.",
              "tools_triggered": "search_notes, append_to_note",
              "expected_behavior": "Appends the line to the end of '20 Projects/Website rebuild/Website rebuild - launch checklist.md' and leaves the rest of the note unchanged."
            },
            {
              "description": "Browse vault structure",
              "prompt": "What folders are in my vault?",
              "tools_triggered": "list_folder",
              "expected_behavior": "Lists the top-level folders: 00 Inbox, 10 Clients, 20 Projects, 30 Playbooks, 40 Meetings, 40 Operations, 50 Areas, 60 Reading, 70 Daily, 80 People and 90 Archive."
            }
          ],
          "negative": [
            {
              "description": "Request unrelated to notes",
              "prompt": "What's the weather in Paris tomorrow?"
            },
            {
              "description": "Access another person's notes",
              "prompt": "Show me the notes in my coworker's Engram vault."
            },
            {
              "description": "Action Engram does not support",
              "prompt": "Email my launch plan to my team."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin does not sell products or process payments.",
        "demo_recording_url": "https://youtu.be/-25120oVXF0"
      },
      "publication": {
        "release_notes": "Initial release: search, read, create, edit and organize notes in an Engram vault."
      }
    }
  }
}

Client extensions

Data this package carries for particular clients. The directory lists the clients named and never reads what is addressed to them.

  • com.openai