Letta MCP Server

🚀 Letta MCP Server

A server that provides proxy management, memory operations, and tools for integration with the Letta system.

🚀 Quick Start

Option 1: Run with Node.js

# Development mode (with hot reloading)
npm run dev:sse     # Use SSE transmission

# Production mode
npm run build       # Build TypeScript first
npm run start:sse   # Use SSE transmission

Option 2: Run with Docker

# Build and run locally
docker build -t letta-mcp-server .
docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp letta-mcp-server

# Or use the public image
docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp ghcr.io/oculairmedia/letta-mcp-server:latest

📁 Directory Structure

• index.js - Entry file
• core/ - Core server functions
• tools/ - Specific implementations of various tools
• transports/ - Server transport implementations (standard input/output and SSE)

💻 Available Tools

Proxy Management

Memory Management

Tool Management

🐳 Docker Operations

# Check running containers
docker ps | grep letta-mcp-server

# Enter the container
docker exec -it letta-mcp-server /bin/sh

⚙️ Configuration Instructions

Add the following configuration to mcp_settings.json:

{
  "letta_mcp": {
    "host": "localhost",
    "port": 3001,
    "disabled": false,
    "always_allow": [
      "upload_tool",
      "attach_tool",
      "list_agents",
      "list_memory_blocks"
    ],
    "timeout": 300
  }
}

For remote instances, use the following configuration:

{
  "remote_letta_tools": {
    "url": "http://your-server:3001/sse",
    "disabled": false,
    "always_allow": [
      "attach_tool", 
      "list_agents",
      "list_tools",
      "get_agent"
    ],
    "timeout": 120
  }
}