Pocket MCP Server
Connect Pocket to Claude, Cursor, and other AI tools
We’re excited to announce Pocket MCP Server – a new way to connect your Pocket recordings directly to AI assistants like Claude, Cursor, and other MCP-compatible tools.
What is MCP?
Model Context Protocol (MCP) is an open standard that lets AI assistants securely access your data. With Pocket’s MCP server, you can now ask AI questions about your recordings, search across all your transcripts, and get insights – all within your favorite AI tools.
What can you do with it?
- "What did I discuss in my meetings last week?"
- "Find all recordings where I talked about the product launch"
- "Summarize my conversation from yesterday"
- Search across all your recordings without leaving your workflow
Setup Instructions
Prerequisites
Get your API key from Pocket Settings → Developer → API Keys.
Your API key starts with pk_....
Cursor
Manual Setup:
- Open Cursor Settings (
Cmd/Ctrl + ,) - Search for "MCP" or go to Features → MCP Servers
- Click Add Server and enter:
{
"pocket": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://public.heypocketai.com/mcp"],
"env": {
"API_KEY": "pk_your_api_key_here"
}
}
}- Restart Cursor.
Claude Desktop
- Open config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Add this configuration:
{
"mcpServers": {
"pocket": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://public.heypocketai.com/mcp"],
"env": {
"API_KEY": "pk_your_api_key_here"
}
}
}
}- Restart Claude Desktop.
- Look for the 🔌 icon showing Pocket tools are connected.
Claude Code (CLI)
Run this command to add Pocket MCP:
claude mcp add pocket --transport http https://public.heypocketai.com/mcp --header "Authorization: Bearer pk_your_api_key_here"Or add manually to ~/.claude/settings.json:
{
"mcpServers": {
"pocket": {
"type": "http",
"url": "https://public.heypocketai.com/mcp",
"headers": {
"Authorization": "Bearer pk_your_api_key_here"
}
}
}
}Restart Claude Code after adding.
Windsurf
Add to your Windsurf MCP config (~/.windsurf/mcp.json):
{
"mcpServers": {
"pocket": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://public.heypocketai.com/mcp"],
"env": {
"API_KEY": "pk_your_api_key_here"
}
}
}
}Cline (VS Code Extension)
- Open VS Code Settings
- Search for "Cline MCP"
- Add to MCP Servers configuration:
{
"pocket": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://public.heypocketai.com/mcp"],
"env": {
"API_KEY": "pk_your_api_key_here"
}
}
}Generic MCP Client (Direct HTTP)
For any MCP-compatible client that supports HTTP transport:
- Endpoint:
https://public.heypocketai.com/mcp - Transport: Streamable HTTP
- Auth Header:
Authorization: Bearer pk_your_api_key_here - Required Headers:
Content-Type: application/jsonAccept: application/json, text/event-stream
Available Tools
| Tool | Description |
|---|---|
pocket_list_recordings | List and filter recordings by date, tags |
pocket_get_recording | Get full transcript and summary |
pocket_get_recording_audio_url | Get temporary audio download link |
pocket_list_tags | Browse all your tags |
Example Prompts
Once connected, try asking:
- "List my recordings from this week"
- "Get the transcript from my last recording"
- "What tags do I have in Pocket?"
- "Find recordings tagged with ‘meeting’"
Troubleshooting
Tools not showing up?
- Make sure you restarted the app after adding config
- Check that your API key is correct (starts with
pk_) - Verify the config file JSON is valid
Authentication errors?
- Regenerate your API key in Pocket Settings
- Make sure there are no extra spaces in the key
This is our first release – feedback welcome! Let us know what’s working and what needs improvement.
