This skill should be used when the user asks to "list starred episodes", "check my podcasts", "what am I listening to", "podcast history", "show notes", "podcast info", "search podcasts", "pocketcasts", "pocket casts", or mentions Pocket Casts integration. Provides read-only access to starred episodes, listening history, show notes, and podcast metadata.
This skill provides read-only access to Pocket Casts data through their API. View starred episodes, listening history, show notes, and podcast metadata.
The CLI script is located at:
${CLAUDE_PLUGIN_ROOT}/scripts/pocketcast.ts
Run commands using:
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/pocketcast.ts <command> [options]
No setup required if you have a "pocketcasts.com" item in 1Password with username/email and password fields.
Create .claude/pocketcast-skill.local.json in your project directory:
{
"email": "[email protected]",
"password": "your-pocket-casts-password"
}
Or create a global credentials file at ~/.config/pocketcast-skill/credentials.json with the same format.
Project-local credentials are automatically added to .gitignore.
# List all starred episodes
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/pocketcast.ts starred
Response fields:
count: Total number of starred episodesepisodes: Array of episode objects# Get recent episodes (default: 50)
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/pocketcast.ts recent
# Get last 10 episodes
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/pocketcast.ts recent --limit=10
Response fields:
count: Number of episodes returnedlimit: Requested limitepisodes: Array of episode objects# Get show notes for a specific episode
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/pocketcast.ts shownotes <episode-uuid>
Response fields:
episodeId: The episode UUIDshowNotes: HTML content of the show notes# Get podcast metadata
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/pocketcast.ts podcast <podcast-uuid>
Returns full podcast metadata including title, author, description, and episode list.
# Get detailed episode metadata
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/pocketcast.ts episode <episode-uuid>
Returns detailed episode metadata including download URL.
# Search starred and recent episodes by title or podcast name
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/pocketcast.ts search "search terms"
Searches across both starred and recent episodes. Matches against episode title and podcast name.
Response fields:
query: The search querycount: Number of matching episodesepisodes: Array of matching episode objectsAll episode lists return objects with these fields:
id: Episode UUID (use with shownotes, episode commands)title: Episode titlepodcastTitle: Name of the podcastpodcastUuid: Podcast UUID (use with podcast command)publishedAt: ISO 8601 publish dateduration: Human-readable duration (e.g., "1h 23m")durationSeconds: Duration in secondsstarred: Whether the episode is starredplayed: Whether the episode has been fully playedplayedUpTo: How far the user has listened (if partially played)All commands output JSON with a consistent structure:
{
"success": true,
"data": {
// Response data here
}
}
Error responses:
{
"success": false,
"error": "Error message here"
}
starredrecent --limit=10starred or recent to find episodesshownotes <uuid> to get full show notesepisode <uuid> for detailed metadatasearch "topic or podcast name"podcast <podcast-uuid>.claude/pocketcast-skill.local.json~/.config/pocketcast-skill/credentials.json