Log inSubmit server
Pepys MCP logo

Pepys MCP

by ankurmans

Transcribe audio, video, YouTube links, and podcast feeds with diarization, timestamps, search, and caption exports.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Pepys MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ankurmans-pepys-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pepys-mcp"
      ],
      "env": {
        "PEPYS_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 9 tools correctly (1mo ago).

Overview

Pepys MCP starts transcription jobs from uploaded media or supported URLs, then returns speaker-labeled, timestamped transcripts. It supports podcast episode selection, whole-feed batching, transcript search, credit checks, and SRT, VTT, TXT, Markdown, or JSON exports. The stdio server requires a Pepys API key and uses pay-once transcription credits.

Use cases

  • Transcribe long audio or video recordings
  • Identify speakers and generate diarized transcripts
  • Select and transcribe podcast episodes from RSS or Apple Podcasts
  • Export timestamped captions in SRT or VTT format
  • Search long transcripts for timestamped quotes or topics

Key features

  • Audio and video transcription from files or URLs
  • Speaker diarization and timestamped segments
  • Podcast episode listing and feed batch transcription
  • SRT, VTT, TXT, Markdown, and JSON export
  • Transcript search with matching timestamped segments
  • Credit balance and transcription job management

Tools9

What Pepys MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

20/20 checks healthy over the last 85d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6h ago via OSV.dev · pepys-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads115Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed9Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

From the project README

pepys-mcp

Transcription for AI agents, by Pepys.

The Pepys transcription MCP server – give any MCP-speaking agent (Claude, ChatGPT, Cursor, Gemini, open-source agents) speaker-labeled, timestamped transcription of audio and video: diarization, SRT/VTT captions, paste-a-link ingestion (YouTube, podcasts, Drive/Dropbox), batch, and word-level export. Pepys never trains on your audio.

The package runs locally over stdio with a Pepys API key. Pepys also hosts a production OAuth connector at https://pepys.co/api/mcp for compatible remote-MCP clients.

Install & configure

Requires Node ≥ 18 and a Pepys API key (pk_live_…) from https://pepys.co/developers. Some capabilities require an account entitlement.

Run it with npx (no global install):

Claude Desktop / Claude Code – claude_desktop_config.json (or claude mcp add):

config.json
{
  "mcpServers": {
    "pepys": {
      "command": "npx",
      "args": ["-y", "pepys-mcp"],
      "env": { "PEPYS_API_KEY": "pk_live_your_key_here" }
    }
  }
}

Cursor – ~/.cursor/mcp.json, same shape. Windsurf / other dev agents – point them at npx -y pepys-mcp with PEPYS_API_KEY in the env.

Optional env: PEPYS_API_BASE (defaults to https://pepys.co/api/v1).

Claude Code plugin

This repo also bundles a Claude Code plugin that points at the hosted OAuth connector (no API key needed):

Code
/plugin marketplace add ankurmans/pepys-mcp
/plugin install pepys

The first tool call opens an OAuth sign-in to your Pepys account. See skills/pepys/SKILL.md for what it can do and example prompts.

Tools

ToolWhat it does
transcribeStart a transcription from a url (file / YouTube / podcast / Drive) or a file_ref. Options: diarize (entitlement required), summary, chapters, translate_to, quality, podcast episode_guid/episode_index. Returns { job_id, status }.
get_transcriptionFetch a job by job_id; set wait_ms:25000 to long-poll short clips to completion in one call.
upload_fileUpload local media (a path or bytes_base64) → a file_ref for transcribe.
list_transcriptionsRecent jobs (id, status, title, minutes).
list_podcast_episodesEpisodes of an RSS/Apple/Spotify feed, with episode_guids.
transcribe_podcast_feedBatch a whole feed (or latest N). Account entitlement required.
export_transcriptExport SRT / VTT / TXT / MD / JSON. Word-level timing requires an account entitlement. (DOCX/PDF: use the web app.)
search_transcriptFind a phrase in a long transcript → only the matching timestamped segments (no full-transcript context load).
ask_transcriptionAnswer a question about a transcript with server-verified, citation-backed claims only.
get_credit_balanceRemaining transcription balance and entitlement state.

Also exposes finished transcripts as the resource pepys://transcription/{id} and a transcribe_and_summarize prompt.

Account limits over MCP: 402 returns an insufficient-balance result, while unavailable capabilities return a clear entitlement result and a supported fallback where one exists. The MCP server does not initiate purchases or link to checkout.

Develop

Terminal
npm install
npm run build      # tsc → dist/ (+ chmod the bin)
npm run smoke      # PEPYS_API_KEY=pk_live_… npm run smoke  – hits the live API to verify your key

Publish

npm run build && npm publish (publishes pepys-mcp). Registry listings (MCP registry, mcp.so, Smithery, PulseMCP, Glama, awesome-mcp-servers) are submitted separately.

About

Built by Pepys. Learn more at pepys.co · MCP server · Developer docs.

License

MIT

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Pepys MCP

The stdio server requires a Pepys API key set in PEPYS_API_KEY.

It accepts uploaded local files and URLs for files, YouTube videos, podcast episodes or feeds, and Google Drive or Dropbox shares.

Yes. transcribe_podcast_feed can submit every episode or the latest N episodes as individual transcription jobs; this is a paid capability.

The server exports SRT, VTT, TXT, Markdown, and JSON. Word-level timing is a paid unlock, while DOCX and PDF exports are available in the Pepys web app.

Related MCP servers

All in Speech-to-Text All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPepys MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ankurmans-pepys-mcp?style=directory)](https://allmcps.com/mcp/ankurmans-pepys-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/ankurmans-pepys-mcp"><img src="https://allmcps.com/api/badge/ankurmans-pepys-mcp?style=directory" alt="Pepys MCP on AllMCPs" /></a>