Integration

Memos integration

Memos is a self-hosted, privacy-first note-taking service built around short markdown notes. The API reads and writes memos with their visibility, pinned state, tags and markdown content, uploads and downloads attachments, adds comments, reactions, relations and share links to a memo, resolves link metadata for URLs found in a note, manages spaces and their members, manages users with their settings, views, notifications, personal access tokens, linked identities and per-user statistics, reads instance profile, statistics and settings, manages identity providers, and transcribes an audio attachment through the instance AI provider. The host is part of the credential because every install is its own deployment. Authentication is a personal access token created in the Memos user settings and sent as a bearer token.

Connect Memos How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

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

What you can do with Memos

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.

Attachment, 7 operations

create_attachmentCreate attachmentPOSTCreateAttachment creates a new attachment.
delete_attachmentDelete attachmentDELETEDeleteAttachment deletes an attachment by name.
get_attachmentGet attachmentGETGetAttachment returns an attachment by name.
list_attachmentsList attachmentsGETListAttachments lists all attachments.
list_memo_attachmentsList memo attachmentsGETListMemoAttachments lists attachments for a memo.
set_memo_attachmentsSet memo attachmentsPATCHSetMemoAttachments replaces the full set of attachments on a memo with the provided list (not an append). Pass the complete desired set; an empty list clears all attachments.
update_attachmentUpdate attachmentPATCHUpdateAttachment updates an attachment.

Memo, 6 operations

create_memoCreate memoPOSTCreateMemo creates a memo. The request body is a Memo; set its content (Markdown) and visibility (PRIVATE | PROTECTED | PUBLIC | SPACE, default PRIVATE). The memo is owned by the.
delete_memoDelete memoDELETEDeleteMemo deletes only the named memo and its owned resources. It removes incident relations but never deletes another memo.
get_memoGet memoGETGetMemo gets a memo.
get_shared_memoGet shared memoGETGetSharedMemo resolves a share token to its memo. No authentication required. Returns NOT_FOUND if the token is invalid or expired.
list_memosList memosGETListMemos lists readable non-comment memos with pagination and filter.
update_memoUpdate memoPATCHUpdateMemo updates a memo.

User, 6 operations

create_userCreate userPOSTCreateUser creates a new user.
delete_userDelete userDELETEDeleteUser deletes a user.
get_userGet userGETGetUser gets a user by username. Format: users/{user} (e.g., users/steven).
get_user_statsGet user statsGETGetUserStats returns statistics for a specific user.
list_usersList usersGETListUsers returns a list of users.
update_userUpdate userPATCHUpdateUser updates a user.

Identity provider, 5 operations

create_identity_providerCreate identity providerPOSTCreateIdentityProvider creates an identity provider.
delete_identity_providerDelete identity providerDELETEDeleteIdentityProvider deletes an identity provider.
get_identity_providerGet identity providerGETGetIdentityProvider gets an identity provider.
list_identity_providersList identity providersGETListIdentityProviders lists identity providers.
update_identity_providerUpdate identity providerPATCHUpdateIdentityProvider updates an identity provider.

Member, 5 operations

add_space_memberAdd space memberPOSTCreateSpaceMember directly adds an existing active user to a space.
get_space_memberGet space memberGETGetSpaceMember gets one membership in a space.
list_space_membersList space membersGETListSpaceMembers lists the members of a space.
remove_space_memberRemove space memberDELETEDeleteSpaceMember removes a member. A member may delete their own membership to leave the space.
update_space_memberUpdate space memberPATCHUpdateSpaceMember changes a member's space role.

Space, 5 operations

create_spaceCreate spacePOSTCreateSpace creates a space and makes the authenticated caller its first administrator.
delete_spaceDelete spaceDELETEDeleteSpace permanently deletes a space and every memo currently placed in it. It never follows memo relations to other memos.
get_spaceGet spaceGETGetSpace gets a space of which the authenticated caller is a member.
list_spacesList spacesGETListSpaces lists spaces of which the authenticated caller is a member.
update_spaceUpdate spacePATCHUpdateSpace updates space metadata.

View, 5 operations

create_memo_viewCreate memo viewPOSTCreateMemoView creates a new memo view for a user.
delete_memo_viewDelete memo viewDELETEDeleteMemoView deletes a memo view for a user.
get_memo_viewGet memo viewGETGetMemoView gets a memo view by name.
list_memo_viewsList memo viewsGETListMemoViews returns a user's memo views. Each view is a named, reusable CEL filter (see MemoView.filter); pass its filter string directly to the ListMemos `filter` argument.
update_memo_viewUpdate memo viewPATCHUpdateMemoView updates a memo view for a user.

Webhook, 5 operations

create_webhookCreate webhookPOSTCreateUserWebhook creates a new webhook for a user.
delete_webhookDelete webhookDELETEDeleteUserWebhook deletes a webhook for a user.
get_webhook_signing_secretGet webhook signing secretGETGetUserWebhookSigningSecret returns the signing secret for a webhook. The secret is returned only through this explicit, owner-gated call; it is never included in.
list_webhooksList webhooksGETListUserWebhooks returns a list of webhooks for a user.
update_webhookUpdate webhookPATCHUpdateUserWebhook updates an existing webhook for a user.

Linked identitie, 4 operations

create_linked_identityCreate linked identityPOSTCreateLinkedIdentity links an SSO identity to the authenticated user.
delete_linked_identityDelete linked identityDELETEDeleteLinkedIdentity unlinks an SSO identity from a user.
get_linked_identityGet linked identityGETGetLinkedIdentity gets a linked SSO identity for a user.
list_linked_identitiesList linked identitiesGETListLinkedIdentities returns a list of linked SSO identities for a user.

Notification, 3 operations

delete_notificationDelete notificationDELETEDeleteUserNotification deletes a notification.
list_notificationsList notificationsGETListUserNotifications lists notifications for a user.
update_notificationUpdate notificationPATCHUpdateUserNotification updates a notification.

Personal access token, 3 operations

create_personal_access_tokenCreate personal access tokenPOSTCreatePersonalAccessToken creates a new Personal Access Token for a user. The token value is only returned once upon creation.
delete_personal_access_tokenDelete personal access tokenDELETEDeletePersonalAccessToken deletes a Personal Access Token.
list_personal_access_tokensList personal access tokensGETListPersonalAccessTokens returns a list of Personal Access Tokens (PATs) for a user. PATs are long-lived tokens for API/script access, distinct from short-lived JWT access tokens.

Reaction, 3 operations

delete_memo_reactionDelete memo reactionDELETEDeleteMemoReaction deletes a reaction for a memo.
list_memo_reactionsList memo reactionsGETListMemoReactions lists reactions for a memo.
upsert_memo_reactionUpsert memo reactionPOSTUpsertMemoReaction adds or updates the authenticated user's reaction on a memo.

Setting, 3 operations

get_user_settingGet user settingGETGetUserSetting returns the user setting.
list_user_settingsList user settingsGETListUserSettings returns a list of user settings.
update_user_settingUpdate user settingPATCHUpdateUserSetting updates the user setting.

Share, 3 operations

create_memo_shareCreate memo sharePOSTCreateMemoShare creates a share link for a memo. Requires authentication as the memo creator.
delete_memo_shareDelete memo shareDELETEDeleteMemoShare revokes a share link. Requires authentication as the memo creator.
list_memo_sharesList memo sharesGETListMemoShares lists all share links for a memo. Requires authentication as the memo creator.

Comment, 2 operations

create_memo_commentCreate memo commentPOSTCreateMemoComment atomically creates an independent memo plus one immutable COMMENT context relation to the named memo. The new memo keeps its own placement, visibility.
list_memo_commentsList memo commentsGETListMemoComments lists comments for a memo.

Relation, 2 operations

list_memo_relationsList memo relationsGETListMemoRelations lists relations for a memo.
set_memo_relationsSet memo relationsPATCHSetMemoRelations replaces the full set of mutable REFERENCE relations on a memo. COMMENT relations are immutable creation context and are rejected by this RPC. An empty list.

Ai transcribe, 1 operation

transcribe_audio_attachmentTranscribe audio attachmentPOSTTranscribe transcribes an audio file using an instance AI provider.

Attachments batch delete, 1 operation

batch_delete_attachmentsBatch delete attachmentsPOSTBatchDeleteAttachments deletes multiple attachments in one request.

Link metadata, 1 operation

get_link_metadataGet link metadataGETGetLinkMetadata gets metadata for a link.

Link metadata batch get, 1 operation

batch_get_link_metadataBatch get link metadataPOSTBatchGetLinkMetadata gets metadata for links.

Me, 1 operation

get_current_userGet current userGETGetCurrentUser returns the authenticated user's information. Validates the access token and returns user details. Similar to OIDC's /userinfo endpoint.

Notification test email, 1 operation

send_test_notification_emailSend test notification emailPOSTTests notification email delivery with the provided or stored SMTP settings.

Profile, 1 operation

get_instance_profileGet instance profileGETGets the instance profile.

Settings batch get, 1 operation

batch_get_instance_settingsBatch get instance settingsPOSTBatch gets instance settings.

Stat, 1 operation

get_instance_statsGet instance statsGETGetInstanceStats returns resource usage statistics for the instance. Admin only.

Users batch get, 1 operation

batch_get_usersBatch get usersPOSTBatchGetUsers returns active users by usernames.

Users stat, 1 operation

list_all_user_statsList all user statsGETListAllUserStats returns statistics for all users.

Use Memos from Claude Code, Cursor or Codex

Connect Memos in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Memos 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 Memos

Create your workspace
Sign up free. Nothing to install.
Connect Memos once
Add your Memos 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.