# Plaud MCP

> Plaud manages your entire AI voice recording library. Connect your agent to instantly list recordings, retrieve full transcripts, and pull AI-generated summaries from client meetings or lectures. It handles metadata updates, folder organization, and secure downloading of your spoken data.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** voice-recording, transcription, meeting-summaries, ai-summarization, audio-processing, voice-to-text

## Description

You connect your agent directly to Plaud. Forget clicking around dashboards; you just ask for it. Your agent handles your whole voice recording library—the listing, the data pulls, and the clean-up. 

To get a full picture of your content, you can start by calling `list_files` to see every single audio file stored in your account. You'll also call `list_folders` to map out all the top-level folders Plaud uses for organization, and `list_tags` gives you an inventory of every tag applied across your whole recording collection.

For granular detail on any specific recording, you can call `get_file_detail`, which pulls key metadata like the exact creation date. You'll also run `get_me` to check general status details about your connected Plaud account itself. The agent gives you full visibility into what's stored right off the bat.

When it comes to pulling data out of those recordings, the agent has a few specific tools. If you need the complete text—the word-for-word transcript—you call `get_transcript` and get that raw text back immediately. Need quick context? You run `get_summary`, which generates an AI-written summary highlighting the main points from any selected recording file without you having to listen to the whole thing. 

For data governance, you've got options for managing the files themselves. If you need to download the original audio, you call `get_download_url` and get a secure MP3 link for that specific recorded file. You can change things up too; if a recording needs renaming or its metadata adjusted, you run `update_file`. When the data is stale, you use `delete_file` to take a specific Plaud audio recording completely off your account.

This whole setup means your agent doesn't just read files; it manages them. You can pull all those pieces of information—the file list, folder structure, tag inventory, metadata details, summaries, full transcripts, and secure download links—all through direct calls to the server. It keeps you in control of every asset, so you don't lose track of a thing.

## Tools

### delete_file
Deletes a specific Plaud audio recording from your account.

### get_download_url
Retrieves the secure MP3 download URL for any given recorded file.

### get_file_detail
Pulls specific metadata, like creation dates, for a single Plaud recording.

### get_me
Retrieves general details about your connected Plaud account status.

### get_summary
Generates and returns the AI-written summary for a specified recording file.

### get_transcript
Retrieves the full, raw text transcription of an audio recording.

### list_files
Lists every Plaud recording currently stored in your account.

### list_folders
Returns a list of all top-level folders used to organize recordings.

### list_tags
Provides an inventory of all tags applied across your Plaud recording library.

### update_file
Changes the name or metadata for an existing Plaud recording file.

## Prompt Examples

**Prompt:** 
```
List my last 5 recordings in Plaud.
```

**Response:** 
```
I've retrieved your recent recordings. You have 5 files, including 'Client Meeting Q4' and 'Podcast Draft'. Would you like the transcript for any of them?
```

**Prompt:** 
```
Summarize the recording titled 'Strategy Session'.
```

**Response:** 
```
I've analyzed the 'Strategy Session'. The main points discussed were the 2024 budget and the new hiring plan. I can provide the full AI summary if you'd like.
```

**Prompt:** 
```
Show me my recording folders.
```

**Response:** 
```
You have 3 folders in Plaud: 'Work', 'Personal', and 'Archive'. I can list the recordings inside any of these folders for you.
```

## Capabilities

### Audit Recording Library
List all stored Plaud audio files and retrieve detailed metadata, including creation dates.

### Extract AI Summaries
Generates a concise summary of the main points from any selected recording using `get_summary`.

### Get Full Transcripts
Pulls the complete, word-for-word text transcript for any audio file via `get_transcript`.

### Organize Content Structure
Lists all available folders and tags to map out your entire recording library structure.

### Manage File Assets
Renames recordings (`update_file`) or generates secure download URLs for the original MP3 audio files.

## Use Cases

### Need key decisions from a massive meeting file?
A project manager needs the outcome of a 90-minute planning call. Instead of scrubbing through the transcript, they ask their agent to `get_summary` for that specific recording. The agent delivers the main points—the budget and next steps—in seconds.

### Lost an old file in hundreds of recordings?
A student needs a lecture from last semester, but they don't remember where it's saved. They ask the agent to `list_folders` and then filter using `list_tags` until the specific folder is found, saving hours of browsing.

### Need to share an audio file with a client?
A consultant needs to send only the MP3 recording of a conversation. They don't want to upload it manually; they ask the agent to `get_download_url`, which provides a secure link for immediate sharing.

### Recording name is wrong and confusing?
A content creator recorded notes under 'Meeting Draft 1' but should be archived as 'Podcast Idea - Q3'. They use `update_file` to rename the recording metadata immediately, keeping their library clean.

## Benefits

- Stop manually checking dashboards. Use `list_files` to get an immediate overview of all available recordings in one chat query.
- Go past simple summaries. The `get_transcript` tool pulls the complete text, letting you search for specific quotes or names across hours of audio.
- Keep your data organized without touching folders. List tags (`list_tags`) and use `update_file` to rename recordings instantly when a project changes focus.
- Save time on post-meeting notes. Running `get_summary` pulls the main takeaways, letting you draft reports in minutes instead of hours.
- Maintain local backups easily. Use `get_download_url` to grab secure MP3 links for sharing or archiving without needing a dashboard login.

## How It Works

The bottom line is that your AI client talks to Plaud's API; you never touch a dashboard.

1. Subscribe to the Plaud server and provide your unique Access Token and API Domain.
2. Your agent uses a tool like `list_files` or `get_summary` to query the recording data via conversation.
3. The server returns structured results (e.g., transcripts, metadata lists) directly to your AI client.

## Frequently Asked Questions

**How do I list all my Plaud files using list_files?**
You simply ask your agent to 'List all recordings.' The `list_files` tool pulls the complete inventory, giving you names and basic metadata for everything stored.

**Can get_transcript work if I only have a folder name?**
No. `get_transcript` requires a specific file ID or title to operate. You must first use `list_files` or similar tools to identify the exact recording you need.

**What is the difference between get_summary and get_file_detail?**
`get_summary` uses AI to analyze the content and pull out main talking points. `get_file_detail` only pulls structured metadata, like when the file was created or its current name.

**How do I make sure my files are organized with update_file?**
Use `update_file` by providing the recording's unique ID and the new name you want it to have. You can rename a file in one command.

**How does the `delete_file` tool handle permanent data removal?**
The `delete_file` tool executes a permanent deletion of the recording. This action is irreversible, so always verify the file ID using `get_file_detail` before calling it. We recommend running a dry run check first.

**What parameters does the `get_download_url` tool need to generate an MP3 link?**
You must provide a valid recording ID. The function returns a temporary, secure download URL for the audio file. Keep in mind that these links expire after a set timeframe for security purposes.

**How do I check all available organization categories using `list_tags`?**
The `list_tags` tool returns every tag currently assigned to your Plaud recordings. This list shows you exactly what filtering and categorization options are live in your account right now.

**If I use `get_file_detail`, what specific data does it provide that `list_files` doesn't?**
The `get_file_detail` tool pulls deep, granular metadata for one specific file ID. It gives you internal system IDs and precise creation timestamps that are not included in the general list view.

**How do I find my Plaud Access Token?**
Log in to [**web.plaud.ai**](https://web.plaud.ai), open DevTools (F12), go to **Application** > **Local Storage**, and look for `tokenstr`. Copy and paste it into the field below.

**What is the Plaud API Domain?**
It is the base URL for the Plaud API (e.g., `https://api-euc1.plaud.ai`). You can find it in your browser's Local Storage under `plaud_user_api_domain`.

**Can the agent retrieve full AI summaries?**
Yes. Use the `get_summary` tool with the File ID. Your agent will fetch the structured AI summary, including key points and action items.