mcpField
S
Samsung Notes

Samsung Notes

ローカル
github.com生産性92 週間前に更新

Samsung Notes について

Samsung Notesは、Samsung Notesライブラリを読むローカルコネクターと、エクスポートしたノートを各種デバイスのブラウザーで開くアプリを提供します。テキスト、手書き、表、画像、PDFに対応し、ノートは変更しません。

主な機能

  1. 01ノート、表、添付ファイルの読み取り
  2. 02ページ画像による手書きの確認
  3. 03テキストやメタデータでノートを検索
  4. 04依頼に応じた添付ファイルのコピー保存
  5. 05ブラウザーでエクスポート済みノートを表示
  6. 06ノートをMarkdownとPDFに出力

活用シーン

  1. 01手書きノートの検索と要約
  2. 02請求書の写真やPDFから情報を抽出
  3. 03Samsung以外のデバイスでエクスポート済みノートを閲覧
  4. 04ノートの内容や添付ファイルをAIアプリに送信

MCP 対応

コネクターはMCPクライアントにSamsung Notesの閲覧、検索、読み取りツールを提供し、依頼に応じて添付ファイルのコピーも保存します。ノート自体は変更しません。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"mhemd139-samsung-notes": {
"command": "npx",
"args": [
"-y",
"samsung-notes-mcp"
]
}
}
}
起動コマンドnpx -y samsung-notes-mcp

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmsamsung-notes-mcp0.1.5

ツール

6

掲載時のツール一覧 · 2 週間前に更新

このツールにパラメーターはありません。

詳細

README の画像

Samsung Notesをどこでも

どのデバイスでもSamsung Notesを開いて、持ち歩き、AIに読み取らせましょう。
無料のオープンソースです。ノートはデバイス上に保存されます。

ブラウザーでInkportを開く  ·  ノートをClaudeに接続する

CI Release npm License: GPL-3.0

ブラウザー上のInkport:ページのプレビューが並ぶSamsung Notesのライブラリと、スマートフォン上の手書きページ

Inkport:どのブラウザーでもノートを開く

Samsung Notesのファイル(.sdocx)はSamsungデバイスでしか開けません。Inkportなら、iPhone、Mac、Windows、Linux、Chromebook、Androidで開けます。

  • 書いたとおりにすべてのページを表示: 手書き、図、入力したテキスト、表、写真、PDF、音声録音に対応しています。
  • すべてを持ち歩く: すべてのノートのMarkdownとPDFを1つのZIPにまとめます。元の日付も保持され、Obsidian、Notion、任意のフォルダーですぐに使えます。
  • ワンタップでAIに送信: Claude、ChatGPT、Geminiに、入力したテキストはテキストファイルとして、手書きのページは画像として、添付された写真とPDFはすべて送信されます。文字起こしや要約、表の作成を依頼できます。スマートフォンでは共有メニューが開き、コンピューターではチャットにドラッグできるファイルが保存されます。1つのメッセージに含められるファイルは最大10個のため、大量に送信する場合はページ画像が1つのPDFにまとめられます。
  • プライベートで無料: ブラウザー上で動作し、ファイルを外部に送信しません。セキュリティポリシーにより、ほかのサイトへのバックグラウンドリクエストはブロックされます。アカウント不要、利用制限なし、オフラインで動作し、21言語に対応しています。

Samsung Notesからノートを書き出す: ノートを長押しして必要なものを選択し、共有 → Samsung Notesファイルを選びます。Androidでは、ChromeのメニューからInkportをインストールし、共有メニューで選択します。続いてAIに送信をタップすると、ノートがAIアプリに渡されます。それ以外の環境では、ファイルを保存(Google Drive、OneDrive、USBメモリ、自分宛てのメールなど)して、Inkportで開きます。

ノートを Claude に接続する

このコネクターを使うと、Claude はコンピューター上の Samsung Notes ライブラリ全体を読み取れます。ノートの検索、ページ画像からの手書き文字の読み取り、請求書の写真や PDF の表示、名前を変更したコピーのフォルダーへの保存ができます。ノートが変更されることはありません。

使用するものインストール方法
Claude Desktopsamsung-notes-mcp.mcpb をダウンロードして開き、Installをクリックしてから、もう一度Installをクリックします。
Claude Code/plugin install samsung-notes --marketplace Mhemd139/Samsung_Notes
VS CodeVS Code にインストール
Codex CLIcodex mcp add samsung-notes -- npx -y samsung-notes-mcp
Gemini CLIgemini mcp add samsung-notes npx -y samsung-notes-mcp
Cursor、Windsurf などアプリの MCP 設定に {"mcpServers": {"samsung-notes": {"command": "npx", "args": ["-y", "samsung-notes-mcp"]}}} を追加します。

Claude Desktop には必要なものがすべて含まれています。それ以外では、Node.js 20.12 以降が必要です。

ノートの取得元:

  • Windows 版 Samsung Notes(どの PC にもインストールできます):設定は不要です。一度開いてサインインし、ノートが同期されるまで待ちます。
  • その他すべて(Mac、Linux):上記の方法で、スマートフォンからノートを 1 つのフォルダーにエクスポートします。Claude Desktop では、拡張機能の設定でそのフォルダーをエクスポート済みノートフォルダーとして選択します。それ以外では、コマンドに --exports "/path/to/folder" を追加します。新しいエクスポートはいつでも同じフォルダーに保存してください。Claude は次の質問時にそれを認識します。
AI エージェントを使ってインストールする

次の内容を Claude Code、Claude Desktop の Code タブ、またはターミナルを使えるエージェントに貼り付けます。コマンドが 1 つ実行されたら、Claude でInstallを 2 回クリックします。

Install the Samsung Notes Reader extension in my Claude Desktop. Run the command for my system, then tell me to click Install twice in Claude:
Windows (PowerShell): curl.exe -fsSLo "$HOME\Downloads\samsung-notes-mcp.mcpb" https://github.com/Mhemd139/Samsung_Notes/releases/latest/download/samsung-notes-mcp.mcpb; claude-desktop.exe "$HOME\Downloads\samsung-notes-mcp.mcpb"
macOS: curl -fsSLo ~/Downloads/samsung-notes-mcp.mcpb https://github.com/Mhemd139/Samsung_Notes/releases/latest/download/samsung-notes-mcp.mcpb && open -a Claude ~/Downloads/samsung-notes-mcp.mcpb

エージェント向けの注意事項:

  • 上記のコマンドを使って Claude Desktop にインストールしてください。ユーザーに選択を求めないでください。Claude Desktop がインストールされていない場合、またはユーザーが Claude Code を希望した場合にのみ、Claude Code の行を使用してください。
  • claude-desktop.exe が見つからない場合(古い Windows インストールの場合)、代わりに Invoke-Item でファイルを開いてください。その後 Windows がアプリを尋ねてきたら、ユーザーに Claude → Always を選んでもらいます。
  • ユーザーはInstallをクリックし、続けてもう一度Installをクリックします。これは Claude Desktop の仕様です。「Anthropic による検証がありません」という赤いバナーは正常です。claude_desktop_config.json は編集せず、Claude を再起動しないでください。
  • Windows 版 Samsung Notes には設定は不要です。それ以外の場合は、スマートフォンからノートをフォルダーにエクスポートします(「ノートの取得元」を参照)。
  • 新しい Claude Desktop のチャットで「ノートの概要を教えて」と質問して回答が得られたら完了です。
Claude Desktop の手順
  1. 上記の .mcpb ファイルをダウンロードして開き、Installをクリックしてから、もう一度Installをクリックします。
    • Windows で .mcpb ファイルを開くアプリを尋ねられたら、ClaudeとAlwaysを選択します。
    • Anthropic のディレクトリにない拡張機能では、「Anthropic による検証がありません」という赤いバナーが表示されますが、これは正常です。
    • ファイルが Claude で開かない場合は、**Settings → Extensions → Advanced settings → Install Extension…**を選び、ファイルを指定します。
  2. 任意:拡張機能の設定にある保存先フォルダーは、頼んだときに Claude が添付ファイルのコピーを保存する場所です。デフォルトでは、Documents 内の「Samsung Notes」フォルダーです。Google Drive、OneDrive、iCloud、Dropbox に保存するには、そのサービスの同期フォルダー内にあるフォルダーを選択します。
  3. 新しいチャットを開始して、「ノートの概要を教えて」と尋ねます。Claude が各ツールを初めて使うときは、許可を求めます。Always allowを選ぶと、そのツールについて再び尋ねられることはありません。

Claude Code では、プラグインを使わずに claude mcp add --scope user samsung-notes -- npx -y samsung-notes-mcp を実行する方法もあります。エクスポートしたノートには --exports "/path/to/folder" を追加します。添付ファイルを Documents 以外の場所に保存するには、--save-dir "/path/to/folder" を追加します。

### 試しに聞いてみましょう
  • 「メモの概要を教えてください。」
  • 「今年の請求書をすべて探して、取引先、日付、合計金額、メモの表にまとめてください。」
  • 「先週の手書きのメモを読んで、要約してください。」
  • 「『自動車保険』のメモに添付されている PDF には何が書かれていますか?」
  • 「『領収書』フォルダーにある請求書をすべて、日付、取引先、合計金額を名前にしたフォルダーにまとめてください。」
Claude ができること
ツール内容
notes_overviewメモの保存場所、フォルダー、合計数、問題
list_notes単語、フォルダー、日付、添付ファイル、手書き文字で閲覧または検索
read_noteメモの入力テキスト、表、添付ファイルの一覧、手書き文字があるページ
get_page_imageページの画像。Claude はこれを使って手書き文字を読み取ります
get_attachment添付写真、または PDF のテキストとページ画像
save_attachments添付写真や PDF のコピーを、Claude が選んだ名前でフォルダーに保存します。依頼があった場合にのみ実行します

プライバシー

  • Inkport はブラウザー上で動作します。ファイルはお使いのデバイス上で読み取られ、アップロードされることはありません。また、このページにはアナリティクスや Cookie はありません。コンテンツセキュリティポリシーにより、他のサイトへのバックグラウンドリクエストはブロックされます。GitHub Pages はアプリ自体のファイルを配信するため、他のウェブサイトと同様に、GitHub がページへのアクセスを記録する場合があります(GitHub のプライバシーに関する声明)。
  • コネクター はお使いのコンピューター上でメモを読み取ります。サーバー、アカウント、アナリティクスはなく、ネットワークリクエストも行いません。
  • どちらのツールもメモの変更、移動、削除は行いません。コネクターがファイルを書き込むのは、添付ファイルの保存を依頼された場合のみです。保存フォルダーにコピーを作成し、ファイルを上書きすることはありません。
  • チャット中に Claude がメモ、ページ、添付ファイルを開くと、その内容は、貼り付けた内容と同様に、Anthropic のプライバシーポリシーに従ってチャットの一部として Claude に送信されます。Inkport からメモを送信する AI についても同様です。
  • コネクターの各リリースバンドルは、このリポジトリの GitHub ワークフローでビルドされ、来歴証明が付与されます。ダウンロードしたファイルは gh attestation verify samsung-notes-mcp.mcpb --repo Mhemd139/Samsung_Notes で確認してください。
  • お問い合わせ:issue を作成してください。

制限事項

  • 手書き文字はページ画像から読み取るため、検索で見つかるのは入力テキストとタイトルのみです。
  • Inkport の PDF は各ページの画像なので、テキストを選択できません。各 PDF と同じ場所にある Markdown ファイルには入力テキストが記載されています。
  • Inkport はエクスポートをメモリ上で作成します。スマートフォンでは、一度に数百件ずつエクスポートしてください。
  • ロックされたメモはロックされたままです。含めるには、Samsung Notes でロックを解除してください。
  • 極端に長いメモ(250,000 文字超)は、まだ読み取れません。
  • ページ画像では、太字のテキストも通常の太さで表示されます。
  • Windows のソースは Samsung Notes 独自のファイルを読み取ります。Samsung Notes の更新によってファイル形式が変更される可能性があります。その場合は、notes_overview に表示されます。

トラブルシューティング

  • 「Samsung Notes が見つかりません」:「メモの保存場所」を参照してください。
  • 「メモがありません」または「フォルダーが見つかりません」:Samsung Notes の同期が完了するまで待つか、フォルダーを作成してください。再起動は不要です。次の質問で Claude にメモが表示されます。
  • メモが見つからない:ごみ箱にあるメモは対象外です。新しいメモは次の質問で表示されます。再起動は不要です。
  • Claude に notes_overview の実行を依頼する:見つかった問題がすべて一覧表示されます。
  • その他の場合:問題を報告してください。実際のメモは添付しないでください。issue は公開されています。

仕組み

flowchart LR
  phone[Samsung Notes on your phone] -->|sync| cloud[Samsung Cloud]
  cloud -->|sync| app[Samsung Notes for Windows]
  app -->|note folders| server[samsung-notes-mcp]
  phone -.->|share .sdocx| folder[Exported notes]
  folder --> server
  folder --> inkport[Inkport in your browser]
  server <-->|stdio| claude[Claude Desktop / Claude Code / any MCP app]
  inkport -->|Send to AI, Markdown, PDF| anywhere[Any AI, Obsidian, Notion]

開発

npm install
npm test
npm run build
npm run web:dev     # Inkport on http://localhost:5173
npm run pack:mcpb   # one-click bundle for all platforms
npm run smoke       # local check against your own notes; prints counts only

翻訳は web/src/locales にあります。ネイティブスピーカーによる修正は、最も歓迎される貢献です。プロジェクトの構成とルールについては CONTRIBUTING.md、変更内容については CHANGELOG.md、脆弱性の非公開報告については SECURITY.md をご覧ください。

クレジットとライセンス

  • パーサー:twangodev/sdocx(GPL-3.0)。ファイルの内部を確認するには、sdocx.twango.devにある専用ビューアーをお試しください。
  • PDFエンジン:PDFium(@hyzyla/pdfium経由)。
  • テストノート:SDOCX Compatibility Corpus(CC BY 4.0)。
  • 非公式:Samsungとは提携していません。Samsung NotesはSamsung Electronicsの商標です。

GPL-3.0-only。LICENSEをご覧ください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。