Skip to main content
The OpenWhispr MCP server lets AI assistants like Claude, Cursor, and VS Code access your notes, folders, transcriptions, and usage stats directly. It’s hosted at https://mcp.openwhispr.com/mcp and uses the Streamable HTTP transport — no local install needed.

​
Setup

You’ll need an API key with the scopes you want the assistant to access.
AI assistants can create their own API key automatically — see Agent setup.
claude mcp add openwhispr --transport http https://mcp.openwhispr.com/mcp \
  --header "Authorization: Bearer owk_live_YOUR_KEY"

​
Available tools

Once connected, your assistant has access to these tools:
ToolDescription
list_notesList notes with optional folder filtering and pagination
get_noteGet a single note by ID
create_noteCreate a new note
update_noteUpdate a note’s title, content, or folder
delete_noteDelete a note
search_notesSemantic and full-text search across notes
list_foldersList all folders
create_folderCreate a new folder
list_transcriptionsList transcription history
get_transcriptionGet a single transcription by ID
get_usageGet usage stats, word counts, and plan details

​
Example prompts

Try these after connecting:
  • “Show me my recent notes”
  • “Search my notes for the meeting with the design team”
  • “Create a note titled ‘Project Ideas’ in my Work folder”
  • “How many words have I used this month?”
  • “List my transcriptions from today”

​
How it works

The MCP server is a thin wrapper around the OpenWhispr API. Your API key is passed through on every request — the MCP server doesn’t store credentials or session state. Each request creates a fresh, stateless connection. This means it scales horizontally and works with any MCP client that supports Streamable HTTP transport.