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 buffer_unordered
• 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)

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

docker pull ghcr.io/oculairmedia/letta-mcp-server-rust:rust-latest

docker run -d \
  -p 6507:6507 \
  -e LETTA_BASE_URL=http://your-letta-instance:8283 \
  -e LETTA_PASSWORD=your-password \
  -e TRANSPORT=http \
  --name letta-mcp \
  ghcr.io/oculairmedia/letta-mcp-server-rust:rust-latest

Docker Compose

services:
  letta-mcp:
    image: ghcr.io/oculairmedia/letta-mcp-server-rust:rust-latest
    container_name: letta-mcp
    restart: unless-stopped
    ports:
      - '6507:6507'
    environment:
      LETTA_BASE_URL: ${LETTA_BASE_URL}
      LETTA_PASSWORD: ${LETTA_PASSWORD}
      TRANSPORT: http
      PORT: 6507
      RUST_LOG: info
    env_file:
      - .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 | |----------|----------|---------|-------------| | LETTA_BASE_URL | Yes | — | Letta API URL (e.g. http://localhost:8283) | | LETTA_PASSWORD | Yes | — | Letta API password | | TRANSPORT | No | stdio | Transport mode: stdio or http | | PORT | No | 6507 | HTTP port (when TRANSPORT=http) | | RUST_LOG | No | info | Log level: debug, info, warn, error | | RUST_BACKTRACE | No | 0 | Enable backtraces (0 or 1) |

Available Tools

The server provides 7 consolidated tools with 103 operations:

| Tool | Operations | Description | |------|------------|-------------| | letta_agent_advanced | 28 | Agent lifecycle, messaging, conversations, context, export/import | | letta_memory_unified | 24 | Co

... View full README on GitHub