Alpha - 초기 테스트 버전. 공공 건물, 내 자신의 기록에 테스트.

Plaud API 용 Unofficial TypeScript 툴킷 - 핵심 라이브러리, CLI, MCP 서버 및 Obsidian 플러그인.

왜

Plaud는 회의, 대화 및 음성 메모를 캡처 한 AI 전원의 착용 가능한 녹음기 (Plaud Note, Plaud NotePin)을 만들고, 구름에 transcribe를 합칩니다. 훌륭한 하드웨어, 그러나 모든 데이터는 공식 API 또는 내보내기 도구를 사용하여 앱 뒤에 살고 있습니다.

이 툴킷은 자신의 녹음에 대한 프로그래밍 접근 권한을 제공합니다. 오디오 파일을 다운로드, transcript를 끌어, 로컬 폴더에 모든 동기화 - 귀하의 데이터, 워크플로. 4개의 포장을 가진 monorepo로 건축하는:

• @plaud/core - 공유 라이브러리: 인증, API 클라이언트, 구성 관리. 토큰 수명주기를 자동으로 처리하십시오 (가장 지속되는 ~300 일, 만료 30 일 이내에 자동 수정). 플러그 가능 HTTP 전송 (Node fetch] 를 기본으로 운영하고 있습니다. Obsidian 플러그인은 requestUrl] 을 우회 렌더링 CORS)합니다.
• @plaud/cli - 목록, 다운로드, transcribe 및 동기화 녹음에 대한 명령줄 도구.

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