Skip to main content
Glama

Edisnote for AI agents

Let Claude (the desktop app, free plan included, and Claude Code), Codex, Cursor and other AI tools see the notes and images you save with Edisnote.

Collect references in Chrome, then tell your agent "look at the two images I just added to my moodboard note". It sees the actual pictures, not just file names.

  • /edisnote, in the Claude desktop app or the terminal:

    Type

    You get

    /edisnote

    your recent notes to pick from

    /edisnote moodboard

    that note: its text, source links and newest images

    /edisnote moodboard 2

    the 2 newest images in it

    /edisnote moodboard #3

    image 3

    /edisnote recent

    what you just saved, from any note

  • Ask in plain words. "Check my Edisnote references for the Apex signage" works. The agent finds the note and opens the images itself.

  • @ your notes (terminal). Type @ in Claude Code in a terminal and your notes show up next to your files.

It only reads. It never changes, moves, or deletes your notes, and nothing leaves your computer except what your agent sends to its own AI model.

Before you start

  1. Edisnote saves to a folder. In the Edisnote panel, click Sync off in the footer and pick any folder. This finds it on its own: Edisnote leaves a small marker in the folder it syncs to, and that's what it looks for.

  2. Node.js 20 or newer (nodejs.org).

Related MCP server: wyrd-mcp

Install

npx -y edisnote-mcp install

This works the same on Mac and Windows. It adds Edisnote to:

  • the Claude desktop app's chat, on any plan, free included. Quit Claude fully afterwards and open it again. On Windows, right-click the Claude icon by the clock and choose Quit, because closing the window leaves it running.

  • Claude Code for every project, with the /edisnote command. Start a new session.

  • Codex, if you've used it on this computer (the Codex CLI, the IDE extension and the ChatGPT/Codex desktop app share one config). Restart the Codex app.

Then ask "look at my Edisnote note on …".

It finds your Edisnote folder by itself, and follows it if you change folders in Edisnote later. If you have more than one, it asks which. To name one yourself:

npx -y edisnote-mcp install --dir "D:\My Notes"

To check what it can see:

npx -y edisnote-mcp check

Claude desktop app by hand

The installer does this for you. To do it yourself, open Settings → Developer → Edit Config in the app and add this (if the file already has mcpServers, add only the edisnote part inside it):

{
  "mcpServers": {
    "edisnote": { "command": "cmd", "args": ["/c", "npx", "-y", "edisnote-mcp"] }
  }
}

On a Mac use "command": "npx", "args": ["-y", "edisnote-mcp"], and if Claude can't find npx, its full path (run which npx). Quit Claude fully and open it again. This works in the desktop app only: claude.ai in a browser and the phone app can't reach files on your computer.

Codex by hand

The installer does this for you. To do it yourself, add this to ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml):

[mcp_servers.edisnote]
command = "cmd"                                # Mac: "npx"
args = ["/c", "npx", "-y", "edisnote-mcp"]     # Mac: ["-y", "edisnote-mcp"]
startup_timeout_sec = 60

On Windows, Codex starts servers without a shell, so npx needs cmd /c in front. On a Mac, if Codex can't find npx, use its full path (run which npx). There's no /edisnote command in Codex; ask in plain words.

Other apps

Add this to the app's MCP settings (Cursor: ~/.cursor/mcp.json):

{
  "mcpServers": {
    "edisnote": { "command": "npx", "args": ["-y", "edisnote-mcp"] }
  }
}

It finds your folder the same way. To name one, add "--dir", "D:\\My Notes" to args.

What your agent gets

list_notes

Find a note. Searches titles, text and the links images came from.

read_note

A note's text, sources and boards, a numbered list of its images, and the newest ones to look at.

view_images

Specific images by number, or the newest few.

recent_images

The newest images across every note.

Images are numbered in the order they appear in the note. For board images Edisnote records exactly when each one was added; for images in the note body, "newest" goes by when the file was last written, which is usually but not always when you added it.

Images over about 3.7 MB, and formats AI models can't view (SVG, AVIF), are listed by file path instead of sent.

Remove it

claude mcp remove edisnote --scope user

For the Claude desktop app, open Settings → Developer → Edit Config and delete the edisnote entry. For Codex, delete the [mcp_servers.edisnote] section from ~/.codex/config.toml.

Develop

No dependencies. npm test runs the suite with Node's built-in test runner.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to search, read, create, update, and remove personal markdown notes stored locally, providing persistent memory across sessions.
      16 npm
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI clients to read Markdown notes from a single explicitly granted local folder, read-only, with strict containment against access outside that folder.
      1
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to read, create, update, delete, and search markdown notes stored locally.
      -