MCP server

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 a personal API key (owk_live_) with the scopes you want the assistant to access. The MCP server reaches your own notes, so workspace keys aren’t supported here.

AI assistants can create their own API key automatically — see Agent setup.

Claude Code
Claude Desktop
Cursor
VS Code

claude mcp add openwhispr --transport http https://mcp.openwhispr.com/mcp \
  --header "Authorization: Bearer owk_live_YOUR_KEY"

Go to Settings > Integrations > Add MCP Server and enter:

URL: https://mcp.openwhispr.com/mcp
Authorization: Bearer owk_live_YOUR_KEY

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "openwhispr": {
      "url": "https://mcp.openwhispr.com/mcp",
      "headers": {
        "Authorization": "Bearer owk_live_YOUR_KEY"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace, or run MCP: Open User Configuration from the Command Palette for a config that follows you across projects:

{
  "servers": {
    "openwhispr": {
      "type": "http",
      "url": "https://mcp.openwhispr.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:openwhispr_api_key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "openwhispr_api_key",
      "description": "OpenWhispr API key",
      "password": true
    }
  ]
}

VS Code prompts for the key once and stores it securely instead of writing it into the config file. See the VS Code MCP server reference for the full schema.

Available tools

Once connected, your assistant has access to these tools:

Tool	Description
`list_notes`	List notes with optional folder filtering and pagination
`get_note`	Get a single note by ID
`create_note`	Create a new note
`update_note`	Update a note’s title, content, or folder
`delete_note`	Delete a note
`search_notes`	Semantic and full-text search across notes
`list_folders`	List all folders
`create_folder`	Create a new folder
`list_transcriptions`	List transcription history with filtering by language or note
`get_transcription`	Get a transcription by ID, including speaker-attributed segments with timestamps
`get_note_transcript`	Get the transcript for a specific note with structured segments
`get_usage`	Get usage stats, word counts, and plan details

Required scopes

Create the API key with only the scopes you need.

Scope	Tools
`notes:read`	`list_notes`, `get_note`, `search_notes`, `list_folders`, `get_note_transcript`
`notes:write`	`create_note`, `update_note`, `delete_note`, `create_folder`
`transcriptions:read`	`list_transcriptions`, `get_transcription`
`usage:read`	`get_usage`

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”
“Get the transcript from my last meeting note as subtitles”
“Show the transcript for note [id] with speaker segments”

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.

Overview

CLI

Integrations

Open source

Setup

Available tools

Required scopes

Example prompts

How it works

​Setup

​Available tools

​Required scopes

​Example prompts

​How it works

Setup

Available tools

Required scopes

Example prompts

How it works