SDK overview

Which client library to install for which language.

mnueron ships three official client libraries that wrap the hosted REST API:

LanguageInstallSource
TypeScript (Node 18+, Deno, Bun, Workers, browsers)npm install @mnueron/sdksdks/typescript
Python (3.9+)pip install mnueronsdks/python
.NET / C# (6+)Drop MnueronClient.cs into any projectSingle-file, no NuGet

All three speak the same REST surface as the MCP server and the Chrome extension, so mixing clients in one project is fine — they all read and write the same Postgres rows under your org.

When NOT to use the SDKs

If you only want local, free, no-account memory for Claude Desktop, Cursor, Windsurf, Cline, etc., you don't need an SDK at all. Install the CLI from npm and let mnueron setup wire MCP into your tools:

npm install -g mnueron
mnueron setup

The SDKs are for building your own apps that read/write mnueron memory programmatically — e.g. a meeting-notes recorder, a CRM enrichment job, a custom Slack bot, a backend that captures user preferences across sessions.

What's covered

All three SDKs expose the same methods:

  • save / search / list / get / update / delete
  • bulkSearch / bulk_search — up to 25 queries in one HTTP round-trip
  • Date filters on search + list (created_after, created_before, updated_after, updated_before) — epoch ms
  • metadata_filter — JSON containment on the metadata jsonb column
  • namespaces + health
  • Webhook CRUD: listWebhooks / createWebhook / getWebhook / updateWebhook / deleteWebhook
  • verifyWebhookSignature — constant-time HMAC-SHA256 check for incoming deliveries

All raise / throw a typed MnueronError / MnueronException on non-2xx responses with the server's error message attached.

Auth

Grab a token at /account-settings/tokens. Set it once via env var and every SDK will pick it up automatically:

export MNUERON_API_KEY=mnu_xxxxxxxxxxxxxxxxxxxxx

Pick a language below for end-to-end examples.

Last updated 2026-05-26edit