Letta MCP Server

Letta MCP servers enable AI models to interact with the Letta platform, providing capabilities for agent management, memory operations, and tool integration.

GitHub starsnpm versionnpm downloads

Overview

The Letta MCP Server provides a bridge between AI models and the Letta agent management system. It allows language models to create, manage, and interact with Letta agents, their memories, and associated tools in a standardized way.

Created by:

Developed by Oculair Media

Key Features

🤖

Agent Management

Create, modify, clone, and manage Letta agents

🧠

Memory Operations

Handle memory blocks and passages for agents

🔧

Tool Integration

Attach and manage tools for agents with full MCP support

📊

Enhanced Metadata

Output schemas and behavioral annotations for all tools

Available Tools

The Letta MCP server offers consolidated tools that use a discriminator pattern. You specify the desired operation within the tool arguments.

Quick Reference

ToolPurposeCategory
agentManage Letta agentsAgent Management
memoryHandle memory blocksMemory
toolManage agent toolsTool Management

Detailed Usage

agent

Perform operations on Letta agents, such as creating, listing, or messaging.

// Create a new agent
use_mcp_tool({
  server_name: "letta",
  tool_name: "agent",
  arguments: {
    operation: "create_agent",
    name: "My New Agent",
    model: "openai/gpt-4"
  }
});

// Send a message to an agent
use_mcp_tool({
  server_name: "letta",
  tool_name: "agent",
  arguments: {
    operation: "message_agent",
    agent_id: "agent-123",
    message: "Hello, agent!"
  }
});
memory

Manage memory blocks for agents.

// Create a memory block
use_mcp_tool({
  server_name: "letta",
  tool_name: "memory",
  arguments: {
    operation: "create_memory_block",
    name: "agent_persona",
    label: "persona",
    value: "You are a helpful assistant."
  }
});
tool

Manage tools for agents.

// List available tools
use_mcp_tool({
  server_name: "letta",
  tool_name: "tool",
  arguments: {
    operation: "list_tools"
  }
});

Installation

{
  "mcpServers": {
    "letta": {
      "command": "npx",
      "args": [
        "-y",
        "letta-mcp-server"
      ],
      "env": {
        "LETTA_BASE_URL": "https://your-letta-instance.com/v1",
        "LETTA_PASSWORD": "your-secure-password"
      }
    }
  }
}

Sources