Skip to content
MCP server

Samsung Notes

Let Claude read your Samsung Notes: typed text, tables, handwriting, photos and PDFs

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Windows, macOS
Runs
Locally
Version
0.1.5
Listing updated
1 day ago

About Samsung Notes

Samsung Notes is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Samsung Notes files only open on Samsung devices, and this project offers two pieces for that gap. Inkport is a browser app that opens exported .sdocx files on iPhone, Mac, Windows, Linux, Chromebook and Android, runs offline in 21 languages and sends nothing to a server. The MCP connector then lets an assistant search and read the library on your computer, always read-only: it never changes, moves or deletes a note.

Handwriting is handled by returning a page as an image so the model reads it visually. The tools give an overview of folders and totals, list or search notes by words, folder, date, attachments or handwriting, read a note's text, tables and attachment list, return page images, fetch an attached photo or a PDF's text and page images, and, only on request, save renamed copies of attachments into a folder without overwriting files.

On Windows with Samsung Notes installed, nothing needs configuring. On Mac or Linux you export notes from your phone into a folder and point the server at it with --exports. Claude Desktop installs through a one-click .mcpb bundle; other clients need Node.js 20.12 or newer. The README says there is no server, no account, no analytics and no network requests.

Install

Run in a terminal

claude mcp add samsung-notes -- npx -y samsung-notes-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "samsung-notes": {
      "command": "npx",
      "args": [
        "-y",
        "samsung-notes-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "samsung-notes": {
      "command": "npx",
      "args": [
        "-y",
        "samsung-notes-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "samsung-notes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "samsung-notes-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

notes_overview
Where notes come from, folders, totals and problems
list_notes
Browse or search notes by words, folder, date or attachments
read_note
A note's text, tables and attachment list
get_page_image
A page as an image for reading handwriting
get_attachment
An attached photo, or a PDF's text and page images
save_attachments
Save copies of attachments into a folder on request

What it does

Handwriting by image
Pages are passed as images so the model can read handwriting.
Read-only access
Notes are never changed, moved or deleted.
Attachment handling
Fetch photos and PDF text or pages.
Search filters
Find notes by text, folder, date, attachments or handwriting.
Exports for any OS
Point at a folder of exported notes on Mac or Linux.
Browser viewer
Inkport opens .sdocx files without a Samsung device.

Good for

  • Ask for an overview of your notes
  • Find all invoices in notes and tabulate vendor, date and total
  • Summarise last week's handwritten notes
  • Read a PDF attached to a note
  • Save invoice attachments into dated, named folders

Pricing

Open source

Free and open source

Samsung Notes FAQ

Can it edit my notes?

No, it never changes a note.

Does it send my notes anywhere?

The README says it makes no network requests and has no server or account.

What do I need on Mac or Linux?

Export notes from your phone into a folder and point the server at it.

What Node.js version is needed?

20.12 or newer, except Claude Desktop which bundles what it needs.

Is Samsung Notes free?

Yes. Samsung Notes is open source, so you can use and self-host it for free.

How do I add Samsung Notes to Claude Code?

Run this command in your terminal: claude mcp add samsung-notes -- npx -y samsung-notes-mcp

What are the best alternatives to Samsung Notes?

The closest alternatives to Samsung Notes are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Samsung Notes

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools