Letta MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Uses .env files for configuration, allowing storage of Letta API credentials and endpoints securely outside of the codebase.

  • Repository hosting for the Letta MCP server, enabling version control, contribution workflows, and distribution of the server code.

  • Provides package management for the Letta MCP server, managing dependencies and offering scripts for building and running the server.

Letta MCP Server

An MCP (Model Context Protocol) server implementation for interacting with the Letta API. This server provides tools for managing agents, memory blocks, and tools in the Letta system.

Features

  • Create and manage Letta agents
  • List and filter available agents
  • Create and manage memory blocks
  • Attach memory blocks to agents
  • List and manage agent tools
  • Send messages to agents and receive responses

Installation

# Clone the repository git clone https://github.com/oculairmedia/Letta-MCP-server.git cd letta-server # Install dependencies npm install

Configuration

  1. Create a .env file in the root directory with the following variables:
LETTA_BASE_URL=your_letta_api_url LETTA_PASSWORD=your_letta_api_password

You can use the provided .env.example as a template.

Available Scripts

  • npm run build: Build the TypeScript code
  • npm run start: Build and start the server
  • npm run dev: Start the server in development mode with watch mode enabled

Tools

Agent Management

  • create_agent: Create a new Letta agent with specified configuration
  • list_agents: List all available agents in the Letta system
  • prompt_agent: Send a message to an agent and get a response

Memory Block Management

  • create_memory_block: Create a new memory block
  • list_memory_blocks: List all memory blocks
  • attach_memory_block: Attach a memory block to an agent

Tool Management

  • list_tools: List all available tools
  • list_agent_tools: List tools available for a specific agent
  • attach_tool: Attach a tool to an agent

Example Usage

When integrated with Cline, you can use the MCP tools as follows:

// Create a memory block <use_mcp_tool> <server_name>letta</server_name> <tool_name>create_memory_block</tool_name> <arguments> { "name": "example_block", "label": "custom", "value": "This is an example memory block." } </arguments> </use_mcp_tool> // Attach the block to an agent <use_mcp_tool> <server_name>letta</server_name> <tool_name>attach_memory_block</tool_name> <arguments> { "block_id": "returned_block_id", "agent_id": "target_agent_id" } </arguments> </use_mcp_tool>

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

An MCP server implementation that enables interaction with the Letta API for managing agents, memory blocks, and tools in the Letta system.

  1. Features
    1. Installation
      1. Configuration
        1. Available Scripts
          1. Tools
            1. Agent Management
              1. Memory Block Management
                1. Tool Management
                2. Example Usage
                  1. Contributing
                    1. License