Cosmonote MCP

Give Claude, ChatGPT, and any MCP-compatible client secure access to your audio notes, transcripts, summaries, and action items — with one URL and OAuth.

https://nebula.cosmonote.ai/mcp
Connect a client ↓

What is this?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and data sources. The Cosmonote MCP server gives your AI assistant read-only access to your notes, transcripts, summaries, and action items — scoped to your account.

If you need more control, check out the REST API.

Connect your client

Claude

Web, Desktop & Mobile
  1. Open Settings → Connectors
  2. Paste the MCP server URL: https://nebula.cosmonote.ai/mcp
  3. Sign in with your Cosmonote API key via OAuth

Claude Code

Run this command in your terminal:

claude mcp add --transport http cosmonote https://nebula.cosmonote.ai/mcp

Then run /mcp to complete OAuth authorization.

ChatGPT

Search for Cosmonote in the ChatGPT app directory, or add it manually via Settings → Connectors.

Other clients

Cursor, Windsurf, Zed…

Any MCP-compatible client (Cursor, Windsurf, Zed, etc.) can connect using Streamable HTTP with OAuth 2.0 + PKCE:

{
  "mcpServers": {
    "cosmonote": {
      "url": "https://nebula.cosmonote.ai/mcp"
    }
  }
}

Available tools

All tools are read-only and scoped to the authenticated user.

list_notes

List all your notes with title, date, duration, speakers, category, and key points.

read-only
get_note

Get a specific note with full details. Optionally include the transcript segments and/or summary.

read-only
list_action_items

List action items extracted from your notes. Optionally filter by note.

read-only

Example prompts

Summarize my last 3 meetings
What decisions were made in yesterday's team sync?
List all my open action items with their due dates
What did Sarah say about the launch timeline?
Write a follow-up email based on today's meeting
Compare the key points from my last two lectures

Protocol details

Endpoint https://nebula.cosmonote.ai/mcp
Transport Streamable HTTP (JSON-RPC)
Auth OAuth 2.0 + PKCE
Discovery /.well-known/oauth-authorization-server
Access Read-only, user-scoped

Troubleshooting

Connection fails

Make sure the URL is exactly https://nebula.cosmonote.ai/mcp with no trailing slash.

OAuth not working

You'll need a Cosmonote API key. Open the app, go to Settings → API keys, and create one.

No notes showing up

The MCP server only returns notes owned by the account linked to your API key. Make sure you have recorded notes in the app.

Need help?

Contact us at [email protected].