Samsung Notes — MCP server for Claude Code: read your notes
Lets your agent work with the Samsung Notes library on your computer: search it, read handwriting, open attachments and PDFs. Notes stay untouched.
claude mcp add samsung-notes -- npx -y samsung-notes-mcpWhat Samsung Notes does
The server reads Samsung Notes files (.sdocx) stored on your machine. It searches the library, pulls handwritten text out of page images, opens invoice photos and PDFs, and writes renamed copies of attachments into a folder. Nothing is written back into your notes.
Where the notes come from depends on your system. On Windows you just open Samsung Notes once, sign in and let sync finish. On Mac and Linux you export notes from your phone into a single folder and point the server at it: in Claude Desktop that is the “Exported notes folder” setting, elsewhere you append --exports "/path/to/folder" to the command. Drop later exports into the same folder and the agent picks them up on your next question.
Node.js 20.12 or newer is required. Without it npx -y samsung-notes-mcp will not start, so check the version before you wire anything up.
What it helps with
- find one note inside a large Samsung Notes library
- turn handwritten pages into readable text
- pull invoice photos and PDFs out of notes
- save note attachments into a folder with clear names
- hand notes to an agent for a summary or a table
Example prompts for the agent
- Give me an overview of my Samsung Notes
- Find the note about the supplier meeting and summarise it
- Save the attachments from the invoice note into the
invoicesfolder
How to install Samsung Notes
Platform CLI
claude mcp add samsung-notes -- npx -y samsung-notes-mcpPlatform CLI
codex mcp add samsung-notes -- npx -y samsung-notes-mcpConfig file
{
"mcpServers": {
"samsung-notes": {
"command": "npx",
"args": [
"-y",
"samsung-notes-mcp"
]
}
}
}Config file
{
"servers": {
"samsung-notes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"samsung-notes-mcp"
]
}
}
}Platform CLI
gemini mcp add samsung-notes npx -y samsung-notes-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Samsung Notes
How do I install Samsung Notes in Claude Code?
Run claude mcp add samsung-notes -- npx -y samsung-notes-mcp. Make sure Node.js 20.12 or newer is installed first.
What does the Samsung Notes MCP server do?
It reads your Samsung Notes library: searches notes, reads handwriting from page images, opens photos and PDFs, and saves copies of attachments into a folder. It never edits a note.
Where do the notes come from on Mac and Linux?
You export them from your phone into one folder and point the server at it: in Claude Desktop via the “Exported notes folder” setting, elsewhere with the --exports "/path/to/folder" flag.
