> Full SurrealDB documentation index: https://surrealdb.com/docs/llms.txt

# Agent Memory integrations

SDKs, the MCP server, AI SDKs and agent frameworks. Connecting SurrealDB Agent Memory to your stack, plus voice tools and automation.

SurrealDB Agent Memory connects to agents through HTTP, MCP, **official SDKs**, and harness adapters that mirror conversation turns into `POST /api/v1/{context_id}/facts/batch`, using the same provenance and trust model as the server.

The REST surface is described by an OpenAPI specification. The Python, TypeScript, Swift, and Kotlin clients track that spec so request and response shapes stay aligned with the server.

## MCP server (coding assistants)

The server serves native MCP at `/mcp` on the api port, with the same **`Authorization: Bearer`** auth as REST. Prefer this when the client already speaks MCP. Point the client at your instance's `/mcp` endpoint, or install it with [`install-mcp`](https://github.com/supermemoryai/install-mcp):

```bash
npx install-mcp https://<your-context-host>/mcp \
  --client cursor \
  --header "Authorization: Bearer <your-api-key>" --oauth no
```

→ [MCP server install](/docs/agent-memory/integrations/mcp-server/install.md) · Per-client guides: [Claude](/docs/agent-memory/integrations/mcp-server/coding-assistants/claude-desktop-and-code.md) · [Cursor](/docs/agent-memory/integrations/mcp-server/coding-assistants/cursor.md) · [VS Code](/docs/agent-memory/integrations/mcp-server/coding-assistants/vscode.md) · [JetBrains](/docs/agent-memory/integrations/mcp-server/coding-assistants/jetbrains.md) · [JetBrains Air](/docs/agent-memory/integrations/mcp-server/coding-assistants/jetbrains-air.md) · [Zed](/docs/agent-memory/integrations/mcp-server/coding-assistants/zed.md) · [Windsurf](/docs/agent-memory/integrations/mcp-server/coding-assistants/windsurf.md) · [Codex](/docs/agent-memory/integrations/mcp-server/coding-assistants/codex.md) · [Antigravity](/docs/agent-memory/integrations/mcp-server/coding-assistants/antigravity.md) · [OpenCode](/docs/agent-memory/integrations/mcp-server/coding-assistants/opencode.md)

## SDKs

Call SurrealDB Agent Memory directly from application code.

| Language | Package |
| --- | --- |
| Dart | `surrealdb` (import `spectron.dart`) |
| Elixir | `:surrealdb` (`SurrealDB.Memory`) |
| Go | `spectron` package in `surrealdb.go` |
| Haskell | `surrealdb-spectron` |
| JavaScript / TypeScript | `@surrealdb/memory` |
| Kotlin | bundled in `com.surrealdb:kotlin` |
| Python | `surrealdb` (SurrealDB Agent Memory ships inside it) |
| Swift | `AgentMemory` product in `surrealdb.swift` |

→ [Dart](/docs/agent-memory/integrations/sdks/dart.md) · [Elixir](/docs/agent-memory/integrations/sdks/elixir.md) · [Go](/docs/agent-memory/integrations/sdks/go.md) · [Haskell](/docs/agent-memory/integrations/sdks/haskell.md) · [JavaScript & TypeScript](/docs/agent-memory/integrations/sdks/javascript-and-typescript.md) · [Kotlin](/docs/agent-memory/integrations/sdks/kotlin.md) · [Python](/docs/agent-memory/integrations/sdks/python.md) · [Swift](/docs/agent-memory/integrations/sdks/swift.md)

## AI SDKs

These integrations add memory to the popular TypeScript AI SDKs by wrapping recall and storage around your model calls.

- **Cloudflare Workers AI**: the client inside a Worker, alongside Workers AI models.
- **TanStack AI**: the `@surrealdb/memory` client in TanStack Start server routes.
- **Vercel AI SDK**: `@surrealdb/agent-memory-vercel-ai`, via `wrapLanguageModel` middleware and a tool set.

→ [Cloudflare Workers AI](/docs/agent-memory/integrations/ai-sdks/cloudflare-workers-ai.md) · [TanStack AI](/docs/agent-memory/integrations/ai-sdks/tanstack-ai.md) · [Vercel AI SDK](/docs/agent-memory/integrations/ai-sdks/vercel-ai-sdk.md)

## Agent frameworks

Harness adapters expose SurrealDB Agent Memory as agent tools and add automatic per-turn memory, without changing your prompts.

| Framework | Package | Language |
| --- | --- | --- |
| CrewAI | `agent-memory-crew-ai` | Python |
| Eve | `@surrealdb/agent-memory-eve` | TypeScript |
| Google ADK | `agent-memory-google-adk` | Python |
| Hermes Agent | `agent-memory-hermes` | Python |
| LangChain / LangGraph | `@surrealdb/langchain`, `@surrealdb/langgraph` | TypeScript |
| Mastra | `@surrealdb/mastra-ai` | TypeScript |
| OpenAI Agents SDK | `agent-memory-openai-agents-sdk` | Python |
| OpenClaw | `@surrealdb/agent-memory-openclaw` | TypeScript |
| Pydantic AI | `agent-memory-pydantic-ai` | Python |
| Strands Agents | `agent-memory-strands-agents` | Python |

→ [CrewAI](/docs/agent-memory/integrations/frameworks/crewai.md) · [Eve](/docs/agent-memory/integrations/frameworks/eve.md) · [Google ADK](/docs/agent-memory/integrations/frameworks/google-adk.md) · [Hermes Agent](/docs/agent-memory/integrations/frameworks/hermes.md) · [LangChain](/docs/agent-memory/integrations/frameworks/langchain.md) · [Mastra](/docs/agent-memory/integrations/frameworks/mastra.md) · [OpenAI Agents SDK](/docs/agent-memory/integrations/frameworks/openai-agents.md) · [OpenClaw](/docs/agent-memory/integrations/frameworks/openclaw.md) · [Pydantic AI](/docs/agent-memory/integrations/frameworks/pydantic-ai.md) · [Strands Agents](/docs/agent-memory/integrations/frameworks/strands-agents.md)

Frameworks without a dedicated package integrate directly through the SDK.

→ [Agno](/docs/agent-memory/integrations/frameworks/agno.md) · [AutoGen](/docs/agent-memory/integrations/frameworks/autogen.md) · [Camel AI](/docs/agent-memory/integrations/frameworks/camel-ai.md) · [LlamaIndex](/docs/agent-memory/integrations/frameworks/llamaindex.md)

## Voice & realtime

Give voice agents memory that persists across calls.

→ [ElevenLabs](/docs/agent-memory/integrations/voice/elevenlabs.md) · [LiveKit](/docs/agent-memory/integrations/voice/livekit.md) · [Gradium](/docs/agent-memory/integrations/voice/gradium.md)

## Automation

- **n8n**: the `@surrealdb/n8n-nodes-surrealdb` community node, plus SurrealDB Agent Memory over the REST API.
- **Zo Computer**: a Zo skill that calls the SurrealDB Agent Memory SDK for recall and storage.

→ [n8n](/docs/agent-memory/integrations/automation/n8n.md) · [Zo Computer](/docs/agent-memory/integrations/automation/zo-computer.md)

## Observability

Run SurrealDB Agent Memory for memory while an observability platform traces and evaluates the agent.

→ [AgentOps](/docs/agent-memory/integrations/observability/agentops.md) · [Respan](/docs/agent-memory/integrations/observability/respan.md)

## REST API

Call the API over HTTP from any language. End-user routes: `/api/v1/{context_id}/…`. Management: `/api/v1/contexts/…`.

→ [REST integration guide](/docs/agent-memory/integrations/surfaces/rest.md) · [Full reference](/docs/agent-memory/reference/rest-api.md)

## Not shipped yet

- **Embedded in-process library**: use REST or an SDK against a deployed instance ([Embedded quickstart](/docs/agent-memory/quickstarts/embedded.md)).

## Surfaces

- [Filesystem view](/docs/agent-memory/integrations/surfaces/filesystem-view.md) - browse a context as though it were a filesystem

## MCP tools

- [MCP tools reference](/docs/agent-memory/integrations/mcp-server/tools-reference.md) - every tool the MCP server publishes, and what each takes