Connect SpeakPen

For AI agents

You are helping the user connect SpeakPen, their voice notes app. The MCP server is https://speakpen.app/mcp (Streamable HTTP, read-only, OAuth sign-in). Work out which client you are running in, follow that section below, and tell the user when they need to click Allow in their browser.

Tools: searchfetchlist_recent_notes

Claude Code

1. Add the server:

   claude mcp add --transport http speakpen https://speakpen.app/mcp

   Copy

2. Then run /mcp inside Claude Code, pick speakpen and sign in. Your browser opens: sign in to SpeakPen and click Allow.

   /mcp

   Copy

3. Optional: the SpeakPen skill teaches Claude Code when to look in your notes. The plugin also adds the speakpen server, so you can install it instead of running the command above:

   /plugin marketplace add Qumge/speakpen-skill
   /plugin install speakpen@speakpen

   Copy

Codex CLI

1. Add the server:

   codex mcp add speakpen --url https://speakpen.app/mcp

   Copy

2. Sign in. Your browser opens: sign in to SpeakPen and click Allow.

   codex mcp login speakpen

   Copy

Cursor

1. Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

   {
     "mcpServers": {
       "speakpen": {
         "url": "https://speakpen.app/mcp"
       }
     }
   }

   Copy

2. When Cursor asks you to sign in to speakpen, sign in to SpeakPen in your browser and click Allow.

VS Code

1. Add this to .vscode/mcp.json in your workspace, with a token in place of YOUR_TOKEN:

   {
     "servers": {
       "speakpen": {
         "type": "http",
         "url": "https://speakpen.app/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

   Copy

2. Create the token in Settings → Connections → Developers.

Gemini CLI

1. Add the server:

   gemini mcp add --transport http speakpen https://speakpen.app/mcp

   Copy

2. Then, inside Gemini CLI, sign in. Your browser opens: sign in to SpeakPen and click Allow.

   /mcp auth speakpen

   Copy

Other MCP clients

https://speakpen.app/mcp

Authorization: Bearer YOUR_TOKEN

ChatGPT

ChatGPT and Claude are set up by you, in their own settings. An agent can't open those for you.

1. In ChatGPT, add a custom MCP server (ChatGPT's help explains where this is; some plans and workspaces don't allow it).

2. Use this address and choose OAuth sign-in:

   https://speakpen.app/mcp

   Copy

3. Sign in to SpeakPen and click Allow.

Claude.ai and Claude Desktop

1. Open Customize → Connectors, click + Add, then Add custom connector.

2. Name it SpeakPen, paste this address and click Continue. Leave the sign-in settings as they are, click Continue again, then Add:

   https://speakpen.app/mcp

   Copy

3. When Claude asks you to sign in, sign in to SpeakPen and click Allow.

The steps are the same in Claude Desktop.

Obsidian

1. In Obsidian: Settings → Community plugins → Browse → search "SpeakPen Sync" → Install and enable.

2. In SpeakPen, open Settings → Connections and click Generate token on the Obsidian card. Copy the token: it is shown only once.

3. Open SpeakPen Sync settings in Obsidian and paste the token into the API token field.

Notes sync one way: from SpeakPen into your vault.

How voice notes sync to Obsidian →

Check it works

What did I record recently?

Disconnect

Privacy