oculairmedia/Letta-MCP-server

A high-performance Model Context Protocol (MCP) server for Letta AI, built with Rust and the TurboMCP framework.
## Features
7 Consolidated Tools covering 103 operations using the discriminator pattern
High Performance -- Rust, ~10-30MB memory, <500ms startup, parallel fan-out via tokio::join! and bufferunordered
Dual Transport -- stdio (Claude Desktop, Cursor, etc.) and HTTP (production deployments)
Response Size Optimization -- 68-96% reduction in response sizes for LLM context efficiency
Type-Narrowed Schemas -- specific object/array types with per-parameter descriptions (no generic Value params)
Multi-Platform -- macOS, Linux, Windows (x64 and arm64)
Letta 0.16.x Compatible -- archives, conversations, MCP servers v2
MCP 2025-11-25 Compliant -- streamable HTTP transport with SSE
Compile-Time Routing -- zero runtime overhead for tool dispatch via TurboMCP v3 macros
## Quick Start
### npm (Recommended)
bash
npm install -g letta-mcp-server
The correct binary for your platform is installed automatically.
| Platform | Package |
| macOS Intel | letta-mcp-darwin-x64 |
| macOS Apple Silicon | letta-mcp-darwin-arm64 |
| Linux x64 | letta-mcp-linux-x64 |
| Linux arm64 | letta-mcp-linux-arm64 |
| Windows x64 | letta-mcp-windows-x64 |
### Docker
bash
docker pull ghcr.io/oculairmedia/letta-mcp-server-rust:rust-latest
docker run -d \
-p 6507:6507 \
-e LETTABASEURL=http://your-letta-instance:8283 \
-e LETTAPASSWORD=your-password \
-e TRANSPORT=http \
--name letta-mcp \
ghcr.io/oculairmedia/letta-mcp-server-rust:rust-latest
### Docker Compose
yaml
services:
letta-mcp:
image: ghcr.io/oculairmedia/letta-mcp-server-rust:rust-latest
containername: letta-mcp
restart: unless-stopped
ports:
'6507:6507'
environment:
LETTABASEURL: ${LETTABASEURL}
LETTAPASSWORD: ${LETTAPASSWORD}
TRANSPORT: http
PORT: 6507
RUSTLOG: info
envfile:
.env
healthcheck:
test: ['CMD-SHELL', "timeout 1 bash -c '</dev/tcp/localhost/6507' || exit 1"]
interval: 30s
timeout: 10s
retries: 3
## Environment Variables
| Variable | Required | Default | Description |
| LETTABASEURL | Yes | — | Letta API URL (e.g. http://localhost:8283) |
| LETTAPASSWORD | Yes | — | Letta API password |
| TRANSPORT | No | stdio | Transport mode: stdio or http |
| PORT | No | 6507 | HTTP port (when TRANSPORT=http) |
| RUSTLOG | No | info | Log level: debug, info, warn, error |
| RUSTBACKTRACE | No | 0 | Enable backtraces (0 or 1) |
| LETTAMCPMAXVALUELEN | No | 500 | Max characters for block/passages/search values |
| LETTAMCPCOREMEMORYPREVIEWLEN | No | 200 | Max characters for core memory previews |
## Available Tools
The server provides 7 consolidated tools with 103 operations:
| Tool | Operations | Description |
| lettaagentadvanced | 28 | Agent lifecycle, messaging, conversations, context, export/import |
| lettamemoryunified | 24 | Core memory, blocks, archival passages, archives, search |
| lettatoolmanager | 13 | Tool CRUD, attach/detach, bulk operations |
| lettasourcemanager | 15 | Data sources, files, passages, attachments |
| lettajobmonitor | 4 | Job tracking, cancellation, active monitoring |
| lettafilefolderops | 8 | File sessions, folder management |
| lettamcpops | 11 | MCP server lifecycle, tool discovery, v2 API support |