# Snipd MCP

> Connect your AI app to your Snipd account with the Snipd MCP server: search and organize your snips, browse the podcasts you follow, read transcripts, control your play queue and more.

Canonical page: https://www.snipd.com/mcp

The Snipd MCP connects AI apps that support the [Model Context Protocol](https://modelcontextprotocol.io) (MCP), such as Claude, ChatGPT, Codex, Cursor, Muse and Grok Bot, to your Snipd account. Once connected, your AI app can read and organize your snips, browse the podcasts you follow, open episodes and their transcripts, search for moments across your podcasts, manage your play queue, and turn any text into a podcast, all with your Snipd data and on your behalf.

## Connect your AI app

The setup differs by app. Pick yours for step-by-step instructions.

### Claude

Add Snipd as a custom connector:

1. Open [**Settings → Connectors**](https://claude.ai/new#customize/connectors/yours).
2. Click **Add custom connector**.
3. Name it **Snipd** and enter the server URL, then click **Add**.

   ```
   https://mcp.snipd.com/mcp
   ```
4. Click **Connect** and sign in with your Snipd account.

Once connected, Snipd is available in every chat and in Cowork.

Then try it in a new chat with this prompt, or pick one from the [example prompts](#example-prompts):

```
Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fwww.snipd.com%2Fmcp.md%20and%20walk%20me%20through%20adding%20Snipd%20as%20a%20custom%20connector%20in%20Claude%2C%20step%20by%20step.)

Instructions to paste into the app: Read https://www.snipd.com/mcp.md and walk me through adding Snipd as a custom connector in Claude, step by step.

### Claude Code

Install the Snipd plugin. It adds the server and the skills that teach Claude Code how to use it, and keeps both up to date:

```
claude plugin marketplace add snipd-app/snipd-mcp
```

```
claude plugin install snipd@snipd-app
```

Then run `/mcp` inside Claude Code, pick **snipd** and choose **Authenticate**.

The plugin already includes the server, so that is all you need. If you prefer the server alone, without the skills, add it directly instead:

```
claude mcp add --transport http --scope user snipd https://mcp.snipd.com/mcp
```

Then try it in a new session with this prompt, or pick one from the [example prompts](#example-prompts):

```
Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

Instructions to paste into the app: Connect Snipd to you: follow the "Claude Code" section of https://www.snipd.com/mcp.md to install the Snipd plugin, then start the sign-in so I can log in with my Snipd account in the browser, and confirm the connection by calling account_info.

### ChatGPT

In ChatGPT on the web:

1. Open [**Plugins**](https://chatgpt.com/plugins) in the sidebar.
2. Click **Add** in the top right, then **Add custom MCP server**.
3. Name it **Snipd**.
4. Under **Connection**, keep **Server URL** and enter the server URL.

   ```
   https://mcp.snipd.com/mcp
   ```
5. Keep **OAuth** as the authentication, tick **I understand and want to continue** and click **Create as a plugin**.
6. Install the plugin and sign in with your Snipd account.

The plugin then also works in the Chat and Work views of the ChatGPT desktop and mobile apps. For Codex in the desktop app, see [Codex app](#codex-app).

Then try it in a new chat with this prompt, or pick one from the [example prompts](#example-prompts):

```
@Snipd Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fwww.snipd.com%2Fmcp.md%20and%20walk%20me%20through%20adding%20the%20Snipd%20MCP%20server%20as%20a%20plugin%20in%20ChatGPT%2C%20step%20by%20step.)

Instructions to paste into the app: Read https://www.snipd.com/mcp.md and walk me through adding the Snipd MCP server as a plugin in ChatGPT, step by step.

### Codex app

The Codex app is the Codex view of the ChatGPT desktop app. In the ChatGPT desktop app:

1. Open **Settings → MCP servers** and click **Add server**.
2. Name it **snipd**, choose **Streamable HTTP** and enter the server URL.

   ```
   https://mcp.snipd.com/mcp
   ```
3. Save, click **Restart**, then **Authenticate** and sign in with your Snipd account.

The app shares its setup with the [Codex CLI](#codex-cli), so Snipd added in one is available in both. To also get the skills that teach Codex how to use Snipd, install the plugin from the CLI instead.

Then try it in a new thread with this prompt, or pick one from the [example prompts](#example-prompts):

```
Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

Instructions to paste into the app: Connect Snipd to you: follow the "Codex CLI" section of https://www.snipd.com/mcp.md to install the Snipd plugin, then start the sign-in so I can log in with my Snipd account in the browser, and confirm the connection by calling account_info.

### Codex CLI

Install the Snipd plugin. It adds the server and the skills that teach Codex how to use it, and keeps both up to date:

```
codex plugin marketplace add snipd-app/snipd-mcp
```

```
codex plugin add snipd@snipd-app
```

The sign-in opens in your browser. If it does not, run `codex mcp login snipd`. The plugin already includes the server. If you prefer the server alone, without the skills, add it directly instead:

```
codex mcp add snipd --url https://mcp.snipd.com/mcp
```

The CLI shares its setup with the [Codex app](#codex-app), so Snipd is then available there too.

Then try it in a new session with this prompt, or pick one from the [example prompts](#example-prompts):

```
Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

Instructions to paste into the app: Connect Snipd to you: follow the "Codex CLI" section of https://www.snipd.com/mcp.md to install the Snipd plugin, then start the sign-in so I can log in with my Snipd account in the browser, and confirm the connection by calling account_info.

### Cursor

Click **Add to Cursor** above, then click **Install** in Cursor and sign in when prompted. Or open **Settings → MCP**, click **Add new MCP server** and add:

```
{
  "mcpServers": {
    "snipd": { "url": "https://mcp.snipd.com/mcp" }
  }
}
```

Then try it in a new chat with this prompt, or pick one from the [example prompts](#example-prompts):

```
Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=snipd&config=eyJ1cmwiOiJodHRwczovL21jcC5zbmlwZC5jb20vbWNwIn0=)

Instructions to paste into the app: Connect Snipd to you: follow the "Cursor" section of https://www.snipd.com/mcp.md to add the Snipd MCP server to my Cursor MCP configuration, then start the sign-in so I can log in with my Snipd account in the browser, and confirm the connection by calling account_info.

### OpenClaw

In the Control UI of your Gateway, which `openclaw dashboard` opens (or `http://127.0.0.1:18789` on the Gateway machine):

1. Open **Settings → MCP** and, under **Servers**, click **Add server**.
2. Name it **snipd**, keep **Streamable HTTP**, enter the server URL and click **Add server**.

   ```
   https://mcp.snipd.com/mcp
   ```
3. Click the **snipd** row to expand it and turn on **OAuth sign-in**.
4. Click **Sign in**, sign in with your Snipd account in the new tab and return to OpenClaw, which shows **Signed in**.

Changing MCP servers needs admin access to the Gateway. If your Gateway runs on another machine, open the Control UI on its HTTPS address or through an SSH tunnel, because the sign-in cannot return to a plain http address:

```
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
```

Then open `http://127.0.0.1:18789`. Or, from the terminal of the Gateway machine, stop the Gateway, add the server and sign in:

```
openclaw gateway stop
```

```
openclaw mcp add snipd --url https://mcp.snipd.com/mcp --transport streamable-http --auth oauth
```

```
openclaw mcp login snipd
```

Open the URL it prints and sign in. If your browser is on another machine, cancel and run the `--code` command it prints instead. Then start the Gateway again.

Then try it in a new message with this prompt, or pick one from the [example prompts](#example-prompts):

```
Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

[OpenClaw MCP docs](https://docs.openclaw.ai/tools/mcp)

### Perplexity

Custom connectors are available on Perplexity Pro, Max and Enterprise.

1. Open **Account settings → Connectors** and click **Custom connector**, then choose **Remote** if asked.
2. Name it **Snipd**, enter the server URL, and keep **Streamable HTTP** and **OAuth** if the form asks for a transport and authentication.

   ```
   https://mcp.snipd.com/mcp
   ```
3. Click **Add** and sign in with your Snipd account when the prompt opens.

Then try it in a new chat with this prompt, or pick one from the [example prompts](#example-prompts):

```
Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

[Open in Perplexity](https://www.perplexity.ai/search?q=Read%20https%3A%2F%2Fwww.snipd.com%2Fmcp.md%20and%20walk%20me%20through%20adding%20Snipd%20as%20a%20custom%20connector%20in%20Perplexity%2C%20step%20by%20step.)

Instructions to paste into the app: Read https://www.snipd.com/mcp.md and walk me through adding Snipd as a custom connector in Perplexity, step by step.

### Gemini CLI

Add the server, then sign in from inside a session:

```
gemini mcp add --transport http snipd https://mcp.snipd.com/mcp
```

```
/mcp auth snipd
```

Then try it with this prompt, or pick one from the [example prompts](#example-prompts):

```
Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

Instructions to paste into the app: Connect Snipd to you: follow the "Gemini CLI" section of https://www.snipd.com/mcp.md to add the Snipd MCP server, then start the sign-in so I can log in with my Snipd account in the browser, and confirm the connection by calling account_info.

### Muse

Muse adds services outside its connector list as custom connectors, which you ask it to create. In a chat in [Muse](https://muse.ai), on the web or in the app, paste:

```
Create a Custom Connector for the remote MCP server https://mcp.snipd.com/mcp, named Snipd, with OAuth sign-in, and connect it.
```

Muse walks you through the setup. Sign in with your Snipd account when the sign-in window opens (allow pop-ups if your browser blocks it). You can disconnect Snipd under **Settings → Connectors**.

Muse uses Snipd on its own when a request needs it. Try it with this prompt, or pick one from the [example prompts](#example-prompts):

```
Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

Instructions to paste into the app: Create a Custom Connector for the remote MCP server https://mcp.snipd.com/mcp, named Snipd, with OAuth sign-in, and connect it.

[Open Muse](https://muse.ai)

### Grok Bot

In the Grok Bot app:

1. Open **Connect apps** in the sidebar. On mobile, tap your avatar, then **Connect apps**.
2. At the bottom, choose **Add a custom connector**.
3. Name it **Snipd**, choose the remote server type (not **Command**) and enter the server URL. Leave **Client ID** empty.

   ```
   https://mcp.snipd.com/mcp
   ```
4. Click **Add plugin**, then **Authenticate** and sign in with your Snipd account. Snipd then shows under **Installed**.

Or ask your Bot in a chat to add a custom MCP server with the server URL, then click **Authorize** on the card it shows. Connected apps are available to all your Bots.

Then try it in a chat with this prompt, or pick one from the [example prompts](#example-prompts):

```
@Snipd Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

Instructions to paste into the app: Connect Snipd to you: follow the "Grok Bot" section of https://www.snipd.com/mcp.md to add the Snipd MCP server as a custom connector, then start the sign-in so I can log in with my Snipd account in the browser, and confirm the connection by calling account_info.

### Other apps

Any app that supports remote MCP servers over Streamable HTTP can connect to the Snipd server. VS Code, Windsurf, Cline, Zed, Raycast and most other agents accept the same configuration as Cursor:

```
{
  "mcpServers": {
    "snipd": { "url": "https://mcp.snipd.com/mcp" }
  }
}
```

Sign-in is discovered automatically (OAuth 2.1). If your app only supports local MCP servers, run the server through `mcp-remote` instead:

```
npx -y mcp-remote https://mcp.snipd.com/mcp
```

The skills from the Claude Code and Codex plugins also work in other agents:

```
npx skills add snipd-app/snipd-mcp
```

Then try it with this prompt, or pick one from the [example prompts](#example-prompts):

```
Find the best episode about AI from last week in the podcasts I follow on Snipd and add it to my queue.
```

Instructions to paste into the app: Connect Snipd to you: follow the "Other apps" section of https://www.snipd.com/mcp.md to add the Snipd MCP server to your MCP configuration, then start the sign-in so I can log in with my Snipd account in the browser, and confirm the connection by calling account_info.

## What you can do

With Snipd connected, your AI app can work with everything in your Snipd account: your snips, i.e. the moments you saved with their AI-generated notes, the shows you follow, what you listened to and your play queue. It can also search what was said across podcasts and read episode summaries and transcripts. So you can ask it to catch you up on new episodes, find a moment you only half remember, research a topic across podcasts, bring your snips into your own notes or wiki, or line up what to listen to next.

### Snips & notes

- **List your snips**: the moments you saved while listening, with their AI-generated notes (a title and summary you can edit in the app) and tags; find them by show, episode, tag, date or favorites.
- **Read what was said**: the transcript of each snip.
- **Organize with tags**: add tags to snips or take them off, and create or delete tags.
- **Delete snips**: clean up the ones you no longer need.

### Podcasts & episodes

- **Browse the shows you follow**: see what is new in them, for example only what you have not played yet, or the most snipped episodes first.
- **Follow and unfollow shows**: including any show by its RSS feed.
- **Open a show**: its description and episodes, or find an episode by its title.
- **Open an episode**: its AI description, hosts and guests, chapters, mentioned books and how far you got.
- **Get an AI summary**: the key moments and takeaways of an episode.
- **Read transcripts**: the full transcript of an episode, with who said what (Premium).
- **Follow guests**: see the newest episodes they appear in.
- **Favorites**: see your favorite episodes, add and remove favorites.
- **See your custom lists**: the episode lists you created in the app, and the episodes in them.

### Search & discover

- **Search what was said**: find where a topic came up in the shows you follow, the episodes you listened to or all public podcasts, also with a particular guest or host; for example, something you heard but did not snip.
- **Find people**: the hosts and guests of podcasts, by name or by what they do, such as "longevity researcher".
- **Discover**: what is trending on Snipd and the most snipped episodes.

### History & play queue

- **See your history**: what you listened to and where you left off.
- **Manage your queue**: add episodes to play next or last, or remove them.

### Uploads

- **Upload audio and video**: a file or a YouTube video becomes an episode in your library that you can listen to and snip. This works in AI apps that can run commands on your computer or a sandbox in the cloud, such as Claude Code or Codex.
- **Turn text into a podcast**: an article or script becomes a private episode narrated by the Snipd DJ.
- **Check pending uploads**: see what is still processing and clean up failed ones.

Uploads and text to speech are Snipd Premium features. Text to speech is not available in Claude on the web, desktop and mobile (Claude Code has it).

While almost all features are entirely free to use, some features, such as summaries or searching through transcripts, use AI credits. Free accounts can use a limited amount of the paid features for free each calendar month. Snipd Premium includes much more usage as well as Premium-only features such as full transcripts, uploads and text to speech. Your AI app sees what each feature costs in AI credits.

## Example prompts

Things to say to your AI app once Snipd is connected.

### Getting started

- Create a visual report on my Snipd listening and snipping behavior.
- Learn what podcasts I like the most based on my past Snipd listening and snipping history.
- Create a local wiki with all of my snips from Snipd.
- Suggest a set of tags for my snips.

### Day to day

- What is new in the shows I follow? Queue the two most interesting episodes.
- What is trending on Snipd right now?
- Go through my snips from last week and add them to my local wiki. Show me the best ones.
- Resurface some great snips I took on longevity.
- What sleep advice did Huberman give in the episode I listened to last month?
- What has Jensen Huang said about running Nvidia without one-on-ones?
- Summarize the latest episode of DOAC.
- Queue up the latest episode of DOAC.
- Find podcast episodes on Snipd with longevity researchers/professors as guests.
- Turn this article into a podcast episode in my Snipd uploads.
- Create a custom 10min podcast about peptides by researching everything I need to know and uploading the audio-first script to Snipd for me to listen to.

## Supported tools

The tools your AI app gets, in case you want to point it at one by name.

### Account, snips and tags

| Tool | What it does |
|---|---|
| `account_info` | The Snipd account the connection is signed in as, its plan and its AI credits. |
| `snips_list` | Your snips, newest first, grouped by episode, with their AI-generated notes and tags; filters by date, show, episode, tag, favorites and auto snips. |
| `snips_details` | Snips with their episode and what is said in them, up to 7 minutes. |
| `snips_tag` | File snips under tags, creating tags that do not exist yet. |
| `snips_untag` | Take tags off snips. |
| `snips_delete` | Delete snips. |
| `tags_list` | Your tags and how many snips carry each. |
| `tags_create` | Create an empty tag. |
| `tags_delete` | Delete a tag from your account; the snips are kept. |

### Shows

| Tool | What it does |
|---|---|
| `followed_shows_list` | The shows you follow. |
| `followed_shows_latest_episodes` | Episodes of the shows you follow, with the filters of the app's custom lists. |
| `show_follow` | Follow a show by id or RSS feed URL. |
| `show_unfollow` | Unfollow a show. |
| `shows_details` | Shows as their page in the app. |
| `shows_episodes` | The episodes of a show, with the app's filters. |

### Episodes

| Tool | What it does |
|---|---|
| `episodes_details` | Everything about episodes: AI description, hosts, guests, chapters, mentioned books, your progress. |
| `episodes_ai_summaries` | The key moments and takeaways of episodes. |
| `episodes_transcripts` | An episode's transcript, in full or a part. Premium. |

### Favorites, guests and lists

| Tool | What it does |
|---|---|
| `favorite_episodes_list` | Your favorite episodes. |
| `favorite_episodes_add` | Add episodes to your favorites. |
| `favorite_episodes_remove` | Remove episodes from your favorites. |
| `followed_guests_list` | The guests you follow. |
| `guests_follow` | Follow guests. |
| `guests_unfollow` | Unfollow guests. |
| `followed_guests_latest_episodes` | The newest episodes with the guests you follow. |
| `listen_history_list` | What you listened to, with your progress. |
| `custom_episode_filters_list` | The custom lists you created in the app. |
| `custom_episode_filters_episodes` | The episodes in one of your custom lists. |
| `discover_episodes` | Trending and most snipped episodes, as on the Discover screen. |

### Search

| Tool | What it does |
|---|---|
| `transcripts_search` | Search what was said in the shows you follow, your listen history or all public podcasts. |
| `people_search` | Find people who appear on podcasts, by name or by what they do. |

### Queue

| Tool | What it does |
|---|---|
| `queue_list` | Your play queue. |
| `queue_add` | Queue episodes next or last. |
| `queue_set_current` | Make an episode the head of the queue. |
| `queue_remove` | Remove episodes from the queue. |

### Uploads (Premium)

| Tool | What it does |
|---|---|
| `uploads_initiate` | Start uploading an audio or video file into your library. |
| `uploads_list` | Pending and processed uploads, and your upload quota. |
| `uploads_delete` | Delete a pending upload. |
| `uploads_text_to_speech` | Turn text into a private podcast episode narrated by the Snipd DJ. Not in Claude on the web, desktop and mobile. |

### Feedback

| Tool | What it does |
|---|---|
| `feedback_submit` | Send feedback about these tools to the Snipd team, after you approve the message. |

## FAQ

### Can I connect more than one AI app?

Yes. Each app signs in on its own with the same server URL, and you can connect as many as you like.

### How do I disconnect?

Remove the Snipd connector, app or MCP server in the AI app you connected. That revokes its access to your account.

### Which features need Premium?

Full transcripts, uploads and text to speech are Premium features. Everything else works on every account, at the AI credits it costs. You can upgrade to Premium in the Snipd mobile app, on the **You** screen.

### What costs AI credits?

The AI features: an episode's AI details (AI description, hosts and guests, chapters, mentioned books), AI summaries, transcript search, full transcripts, the AI processing of uploads and text to speech. Everything else is free. Your AI app gets the exact cost of each from the Snipd MCP server, and every answer says what it cost and how many AI credits are left. Your balance is also in the Snipd app.

### What happens when my AI credits run out?

The tools that need AI credits stop working, and your AI app tells you; nothing is charged. Everything else keeps working. To get more AI credits, upgrade to Snipd Premium or, if you already have Premium, buy more, both in the Snipd mobile app. The monthly allowance of Free and Premium accounts resets at the end of each calendar month.

### Can I store retrieved data?

Yes, for your own listening and note-taking. Keeping what belongs to you is fine, such as all your snips or detailed notes and metadata about the episodes you listened to, for example in your notes, your personal knowledge library (PKM) or for your research. What is not allowed, in a PKM or anywhere else, is systematically scraping, collecting and storing data about episodes or shows you have not listened to and have no immediate personal use for, such as the details or transcripts of hundreds of episodes you have not listened to. Using data from Snipd to build a service (either commercial or personal) that competes with Snipd or has the goal of replacing all future Snipd usage is never allowed. For the details, see our [Terms of Use](https://www.snipd.com/terms-of-use).

## Help and feedback

For help, visit the [help center](https://support.snipd.com). To send feedback about the tools, ask your AI app: it sends your message to the Snipd team once you approve it. The plugin and skills are open source at [github.com/snipd-app/snipd-mcp](https://github.com/snipd-app/snipd-mcp).
