Integration

Supernotes integration

Supernotes is a notecard app for personal knowledge management. Create cards from markdown, append to today's daily card, search and read cards, edit or delete them, organise them into collections, comment on cards, share cards through members and share codes, manage card templates and pinned cards, and subscribe webhooks. Managing API keys, e-mail addresses, sign-in tokens, friend requests and app preferences is left to the Supernotes app, and appending to an arbitrary card (a raw-string body) and bulk create keyed by new card ids are not exposed. Authentication is an API key, created in Supernotes under Settings > Manage API Keys, sent in the Api-Key header; a key gives full access to the account.

Connect Supernotes How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Supernotes.Built from the 46 Supernotes tools below, on the connection you add once.

What you can do with Supernotes

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Collection, 5 operations

create_collectionCreate collectionPOSTCreates a collection under an id you choose (a new UUID). spec is either a preconfigured collection (pre_id) or a saved filter with name, description, icon and filter_group.
delete_collectionDelete collectionDELETEDeletes a collection (the saved view only, not the cards it shows). Answers with a success message.
get_collectionGet collectionGETGet the specified collection
list_collectionsList collectionsGETLists the collections you own, each with its id, spec (a preconfigured pre_id, or name, description, icon and filter_group) and view settings.
update_collectionUpdate collectionPATCHChanges a collection's spec, view or order. Leave a field out to keep its current value.

Comment, 4 operations

create_commentCreate commentPOSTAdds a comment to a card under an id you choose (a new UUID). Send the text as markup and its HTML rendering as html; both are required.
delete_commentDelete commentDELETEDeletes a comment from a card.
list_commentsList commentsGETLists the comments on a card, each with its id, author user_id, markup, html and dates.
update_commentUpdate commentPUTReplaces the text of one of your comments on a card; send both markup and html.

Sharing, 4 operations

create_share_codeCreate share codePOSTCreates a share code for a card, granting a role to whoever joins with it. Requires permission on the card. Returns id, code and granted_perms.
delete_share_codeDelete share codeDELETEDeletes a share code so it can no longer be used to join the card.
list_share_codesList share codesGETLists the share codes of a card, each with its id, code and granted_perms.
update_share_codeUpdate share codePUTChanges the role a share code grants.

Template, 4 operations

create_templateCreate templatePOSTCreates a card template under an id you choose (a new UUID), with a name, markup and creation date.
delete_templateDelete templateDELETEDeletes a card template.
list_templatesList templatesGETLists your card templates, each with id, name, markup and dates.
update_templateUpdate templatePUTReplaces a template's name and markup.

Webhook, 4 operations

create_webhookCreate webhookPOSTCreates a webhook that Supernotes calls at the given URL. Returns its id, url and enabled.
delete_webhookDelete webhookDELETEDeletes a webhook.
list_webhooksList webhooksGETLists your webhooks, each with id, url, enabled and the last response code and body it received.
update_webhookUpdate webhookPUTChanges a webhook's URL or turns it on or off. Leave a field out to keep its current value.

Member, 3 operations

list_card_membersList card membersGETLists the members of a card. The answer is an object keyed by user id, each with status, perms (a numeric role) and via_id.
remove_card_memberRemove card memberDELETERemoves a member from a card.
update_card_memberUpdate card memberPUTChanges another member's role on a card.

Card, 2 operations

get_cardGet cardGETReturns one card: data (name, markup, html, tags, color, icon, dates), your membership on it, backlinks and parents.
update_cardsUpdate cardsPATCHUpdates several cards in one call. Pass cards as an object keyed by card id; each value may carry data (name, markup, tags, color, icon), membership and parents. Only the fields sent change. Answer keyed by card id.

Deleted, 2 operations

list_deleted_cardsList deleted cardsGETLists the ids of cards recently deleted from your account. The answer is a list of card id strings.
list_deleted_collectionsList deleted collectionsGETLists the ids of collections you deleted. The answer is a list of collection id strings.

Pin, 2 operations

list_pinsList pinsGETReturns your pinned cards as an object keyed by card id, each with data, membership and parents.
update_pinsUpdate pinsPUTChanges your pinned cards: add or remove the given card ids, or replace the whole list (the default mode is replace).

Profile, 2 operations

get_my_profileGet my profileGETReturns your own public profile: id, username, first_name, last_name, bio and photo.
get_profileGet profileGETReturns one user's public profile: id, username, first_name, last_name, bio and photo.

Specify, 2 operations

get_cardsGet cardsPOSTReturns the full cards for the given card ids (at most 2000). The answer is keyed by card id, each with data, membership and parents. Reads only.
get_profilesGet profilesPOSTReturns the public profiles of the given user ids (id, username, names, bio, photo). Reads only.

Code, 1 operation

get_share_codeGet share codeGETLooks up a share code: returns the code, the role it grants and a preview of the card it shares (id, name, html, tags, owner). Does not join the card.

Daily, 1 operation

append_daily_cardAppend daily cardPUTAppends markdown to the daily card of today (or local_date), creating that daily card when it does not exist yet. The answer is keyed by the daily card's id.

Delete, 1 operation

delete_cardsDelete cardsPOSTPermanently deletes the given cards for every member; this cannot be undone. Use remove_cards to only drop your own access. The answer gives a status per card id (200, 403 or 404).

Friend, 1 operation

list_friendsList friendsGETLists your Supernotes friends, each with other_user (id, username, first_name, last_name, bio, photo). Use other_user.id with invite_card_member.

Invite, 1 operation

invite_card_memberInvite card memberPOSTInvites a friend to a card with a role. Returns the new membership: status, perms and via_id.

Join, 1 operation

join_card_by_share_codeJoin card by share codePOSTJoins the card a share code points to, when the code allows it, and returns the joined card (data, membership, parents).

Known, 1 operation

list_known_profilesList known profilesGETLists the public profiles of every card owner you know (id, username, names, bio, photo).

Remove, 1 operation

remove_cardsRemove cardsPOSTRemoves your own access to the given cards, without deleting them for other members. The answer gives a status per card id (200, 403 or 404).

Select, 1 operation

search_cardsSearch cardsPOSTSearches your cards: free-text search, a parent card, include/exclude ids, date ranges, a filter group, sort and limit. The answer is keyed by card id, each with data, membership and parents. Reads only.

Simple, 1 operation

create_cardCreate cardPOSTCreates one card from a name and markdown markup, optionally with tags, color, icon and parent cards. The answer is keyed by the new card's id; use that id with get_card.

Tag, 1 operation

list_tagsList tagsGETLists every tag known to you. The answer is a list of tag name strings.

User, 1 operation

get_current_userGet current userGETReturns your account: data (id, email, names, username, bio, photo), subscription (type, dates, renewal) and quota.

Use Supernotes from Claude Code, Cursor or Codex

Connect Supernotes in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Supernotes operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Supernotes

Create your workspace
Sign up free. Nothing to install.
Connect Supernotes once
Add your Supernotes connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.