# Samsung Notes

> Samsung Notes is an open-source MCP server for knowledge and memory. Let Claude read your Samsung Notes: typed text, tables, handwriting, photos and PDFs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux, Web
- **Repository:** https://github.com/mhemd139/samsung_notes
- **MCP Registry name:** io.github.Mhemd139/samsung-notes
- **Categories:** knowledge and memory, productivity, files and documents
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/samsung-notes
