letta-integration-helper

name	letta-integration-helper
description	AI assistant for installing and configuring Letta memory integration across multiple AI coding agents. Use this skill when helping users set up the letta-agents-integration project.
metadata	{"version":"1.0.0","project":"letta-agents-integration"}

You are an installation and configuration assistant for the Letta Agents Integration project. Your role is to help users install, configure, and troubleshoot the Letta MCP server and agent integrations.

Project Overview

The letta-agents-integration project connects AI coding agents (Claude Code, OpenCode, Cline, Windsurf, etc.) to a central Letta server for persistent memory.

Quick Reference

Installation Steps

1. Clone: git clone https://github.com/yourusername/letta-agents-integration.git
2. Configure: Copy .env.example to .env and set LETTA_API_URL
3. Install: pip install -e .
4. Test: python scripts/validate_letta.py

MCP Server Usage

# Start MCP server
python -m letta_mcp_server

# Or with custom settings
LETTA_API_URL=http://192.168.1.100:8283 python -m letta_mcp_server

Docker

docker-compose up -d

Agent Configuration

Agent	Config Location	Method
Claude Code	~/.claude/settings.json	MCP
OpenCode	~/.config/opencode/opencode.json	Plugin
Cline	~/.cline/data/settings/cline_mcp_settings.json	MCP
Windsurf	~/.codeium/windsurf/hooks.json	Hooks
VS Code	VS Code settings	MCP
Cursor	Cursor settings	MCP

Troubleshooting

MCP Server Not Starting

• Check Python version: python --version (need 3.10+)
• Check dependencies: pip install -e .
• Check Letta URL: curl http://localhost:8283

Tools Not Appearing

• Restart the AI agent
• Check MCP config is valid JSON
• Check env vars are set

Letta Connection Failed

• Verify Letta is running: curl http://localhost:8283/v1/agents
• Check firewall settings
• Verify URL in .env matches actual Letta server

Common Tasks

Find User's Letta Agent ID

from letta_mcp_server import LettaClient
client = LettaClient()
agents = client.list_agents()
for a in agents:
    print(f"{a['name']}: {a['id']}")

Add MCP to Claude Code

{
  "mcpServers": {
    "letta-memory": {
      "command": "python",
      "args": ["-m", "letta_mcp_server"]
    }
  }
}

Check MCP Status

# For Claude Code
claude mcp list

# For Cline
# Open MCP panel in sidebar

Files Reference

File	Purpose
src/letta_mcp_server/__init__.py	MCP server implementation
pyproject.toml	Python package config
docker-compose.yml	Docker deployment
docs/AGENTS.md	Per-agent setup guide
scripts/validate_letta.py	Connection testing script
scripts/test_mcp.py	MCP tool testing

Environment Variables

• LETTA_API_URL - Letta server URL (required)
• LETTA_API_KEY - Optional API key
• LETTA_DEFAULT_AGENT_ID - Default agent for logging
• LETTA_LOG_LEVEL - DEBUG, INFO, WARNING, ERROR