Letta

🚀 Letta MCP Server

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

🚀 Quick Start

Option 1: Run with Node.js

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

# Production environment
npm run build       # Build TypeScript first
npm run start:sse   # 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 - Main entry file
• core/ - Core functional modules of the server
• tools/ - Specific implementations of various tools
• transports/ - Server transmission implementations (standard input/output and SSE)

✨ Features

Available Tools

Proxy Management

Memory Management

Tool Management

🐳 Docker Operations

# Build the image
docker build -t letta-mcp-server .

# Run the container
docker run -d -p 3001:3001 --name letta-mcp letta-mcp-server

# View logs
docker logs letta-mcp

# Stop the container
docker stop letta-mcp

# Delete the container
docker rm letta-mcp

⚙️ Configure MCP Settings

Add the following configuration to mcp-config.json:

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

For remote instances, you can configure the URL:

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