Alpha — 初期テストバージョン。 パブリックで構築し、自分の録音をテストします。

Plaud API の非公式 TypeScript ツールキット — コアライブラリ、CLI、MCP サーバー、Obsidian プラグイン。

なぜ

Plaudは、会議、会話、音声メモをキャプチャし、クラウド内でそれらをトランクし、まとめるAIを搭載したウェアラブルレコーダー(Plaud Note、Plaud NotePin)を作ります。 優れたハードウェアですが、すべてのデータは公式 API やエクスポートツールなしでアプリの背後にある。

このツールキットは、独自の録画にプログラム的なアクセスを提供します。 オーディオファイルをダウンロードし、トランスクリプトをプルし、すべてのデータをローカルフォルダに同期します。データ、ワークフロー。 4つのパッケージでモノレポとして構築:

-[@plaud/core — 共有ライブラリ:認証、APIクライアント、設定管理。 トークンのライフサイクルを自動的に処理します(トークンは最大〜300日、30日以内に自動リフレッシュ)。 プラグイン可能な HTTP トランスポート (Node fetch]) をデフォルトで実行します。Obsidian プラグインは requestUrl] をレンダラー CORS をバイパスします。 -[@plaud/cli — コマンド・ライン・ツールで、録画をリスト、ダウンロード、トランジスト、および同期させる.

plaud

Alpha — Early test version. Building in public, testing on my own recordings.

Unofficial TypeScript toolkit for the Plaud API — core library, CLI, MCP server, and an Obsidian plugin.

Why

Plaud makes AI-powered wearable recorders (Plaud Note, Plaud NotePin) that capture meetings, conversations, and voice notes, then transcribe and summarize them in the cloud. Great hardware, but all your data lives behind their app with no official API or export tools.

This toolkit gives you programmatic access to your own recordings. Download audio files, pull transcripts, sync everything to local folders — your data, your workflow. Built as a monorepo with four packages:

• @plaud/core — Shared library: authentication, API client, config management. Handles token lifecycle automatically (tokens last ~300 days, auto-refresh when within 30 days of expiry). Requests run through a pluggable HTTP transport (Node fetch by default; the Obsidian plugin injects requestUrl to bypass renderer CORS).
• @plaud/cli — Command-line tool to list, download, transcribe, and sync recordings.
• @plaud/mcp — MCP server that exposes your Plaud recordings to AI assistants like Claude, making your voice notes searchable and accessible from any MCP-compatible tool.
• @plaud/obsidian — Obsidian plugin (“Plaud Pin Sync”) that syncs recordings into your vault as Markdown notes, downloads the audio, and transcribes locally with mlx-whisper.

Setup

git clone https://github.com/sergivalverde/plaud-toolkit.git
cd plaud-toolkit && npm install

1. Login

npx tsx packages/cli/bin/plaud.ts login

Enter your email, password, and region (us/eu). Credentials are stored locally in ~/.plaud/config.json (mode 0600).

Note: If you use Google Sign-In on Plaud, first set a password via “Forgot Password” on web.plaud.ai.

2. CLI Usage

# List recordings
npx tsx packages/cli/bin/plaud.ts list

# Get transcript
npx tsx packages/cli/bin/plaud.ts transcript 

# Download audio
npx tsx packages/cli/bin/plaud.ts download  ./audio/

# Sync all recordings to a folder
npx tsx packages/cli/bin/plaud.ts sync ./plaud-notes/

3. MCP Server

Add to your Claude config (~/.claude.json):

{
  "mcpServers": {
    "plaud": {
      "command": "npx",
      "args": ["tsx", "/path/to/plaud-toolkit/packages/mcp/src/index.ts"]
    }
  }
}

Tools available:

• plaud_list_recordings — list all recordings
• plaud_get_transcript — get transcript by recording ID
• plaud_get_recording_detail — full recording metadata
• plaud_user_info — account info
• plaud_get_mp3_url — temporary MP3 download URL

4. Obsidian Plugin