Альфа** — ранняя тестовая версия. Публичное строительство, тестирование на собственных записях.

Неофициальный набор инструментов TypeScript для API Plaud — базовая библиотека, CLI, MCP-сервер и плагин Obsidian.

Почему

Plaud делает носимые самописцы (Plaud Note, Plaud NotePin), которые фиксируют встречи, разговоры и голосовые заметки, а затем транскрибируют и обобщают их в облаке. Отличное оборудование, но все ваши данные живут за их приложением без официального API или инструментов экспорта.

Этот инструментарий дает вам программный доступ к вашим собственным записям. Загрузите аудиофайлы, вытащите транскрипты, синхронизируйте все с локальными папками — ваши данные, ваш рабочий процесс. Построен как монорепо с четырьмя пакетами:

@plaud/core — Общая библиотека: аутентификация, API-клиент, управление конфигурациями. Жизненный цикл токенов автоматически (токены длятся ~ 300 дней, автоматически обновляются в течение 30 дней после истечения срока действия). Запросы выполняются через подключаемый транспорт HTTP (узел 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