Your notes, inside your AI assistant

Connect Cosmonote to Claude, ChatGPT or another AI assistant. It can then read your recordings, transcripts, summaries and action items, and answer questions about them.

Start here ↓

What this does

Once connected, you can ask your assistant questions like "what did we decide in Monday's meeting?" and it will look through your Cosmonote notes to answer. No copy-pasting, no exporting.

It can only read. Your assistant can never change, delete or record anything, and it only ever sees notes belonging to your own account.

MCP is the open standard that makes this work. You do not need to know anything about it to follow the steps below. If you would rather build something yourself, use the REST API instead.

Before you start

You need one thing: a Cosmonote API key. It takes about thirty seconds.

  1. Open the Cosmonote app on your phone.
  2. Go to Settings → API keys.
  3. Tap Create a key and copy it.

Keep it to hand. Your assistant asks for it once, when you sign in, and never again.

Connect your assistant

Pick the one you use. Every path ends the same way: a Cosmonote sign-in page opens, you paste your key, and you are connected.

https://nebula.cosmonote.ai/mcp
Jump to: Claude Claude Code ChatGPT Cursor, Windsurf, Zed…

Claude

Web, desktop and mobile
  1. Open Claude and go to Settings → Connectors.
  2. Click Add custom connector.
  3. Paste the Cosmonote address into the URL field: 
    https://nebula.cosmonote.ai/mcp
  4. Click Connect. A Cosmonote sign-in page opens.
  5. Paste your API key and approve. Cosmonote now appears in your list of connectors.

Claude Code

In the terminal
  1. Run this command: 
    claude mcp add --transport http cosmonote https://nebula.cosmonote.ai/mcp
  2. Run /mcp inside Claude Code and choose Authenticate.
  3. Paste your API key in the page that opens.

ChatGPT

Web and desktop
  1. Open ChatGPT and go to Settings → Connectors.
  2. Search for Cosmonote in the directory. If it is not there, choose Add custom connector and paste the address above.
  3. Sign in with your API key when prompted.

Cursor, Windsurf, Zed and others

Any app that supports MCP works the same way. Add Cosmonote to its configuration file, then open it and complete the sign-in it offers.

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

The connection uses Streamable HTTP with OAuth 2.0 and PKCE. Nothing else to configure.

Try it

Once connected, ask your assistant anything about what you have recorded.

Summarise 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

What it can see

Three read-only tools, all limited to your own account.

list_notes

Your notes, with title, date, length, speakers, category and key points.

read-only
get_note

One note in full, with its transcript and summary if you ask for them.

read-only
list_action_items

The action items pulled out of your notes, for one note or all of them.

read-only

Technical reference

You do not need any of this to connect. It is here for anyone wiring Cosmonote into an app of their own.

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

The connection fails

Check the address character for character. It is https://nebula.cosmonote.ai/mcp, with no slash at the end.

The sign-in page rejects my key

Keys are copied in full, including any prefix. If in doubt, create a fresh one in Settings → API keys and paste that.

It connects but finds no notes

Your assistant only sees notes belonging to the account that issued the key. Check you are signed into the same Cosmonote account, and that it has recordings in it.

Still stuck

Write to support@cosmonote.ai and tell us which assistant you are connecting.