E

ElizaOS Agents

Connects Cursor IDE to ElizaOS agents through a local server, enabling developers to list, select, a...

60 views
0 installs
Updated Sep 9, 2025
Not audited
Connects Cursor IDE to ElizaOS agents through a local server, enabling developers to list, select, and chat with agents without leaving their coding environment.
  1. Obtain Your ElizaOS Instance Details

    • Make sure your ElizaOS server is running and accessible (typically at http://localhost:3000).
    • You will need the following UUIDs from your ElizaOS environment:
      • ELIZAOS_USER_ID: Your personal ElizaOS user UUID.
      • ELIZAOS_WORLD_ID: The ElizaOS world UUID where your agents reside.
      • ELIZAOS_AGENT_ID: (Optional but recommended) The initial agent UUID you want to connect to.
      • ELIZAOS_ROOM_ID: Should be the same as your AGENT_ID.

    If you do not know your UUIDs:

    • Log in to your ElizaOS server/admin interface and locate your profile, world, and agent details.
    • UUIDs are usually displayed as long alphanumeric strings (e.g., 85e9fa66-6f8c-0f18-922c-d6c962e21e18).
  2. Open the FastMCP Connection Interface in Cursor

    • In Cursor, click the Install Now button for the Society ElizaOS Connector MCP.
    • This will open the FastMCP connection interface where you can fill in the required environment variables.
  3. Fill in the Required ENV Values

    • Enter the following values in the FastMCP interface:
      • ELIZAOS_SERVER_URL: Your ElizaOS server URL (e.g., http://localhost:3000)
      • ELIZAOS_USER_ID: Paste your actual ElizaOS user UUID.
      • ELIZAOS_WORLD_ID: Paste your actual ElizaOS world UUID.
      • ELIZAOS_AGENT_ID: (Optional, but recommended) Paste your agent's UUID.
      • ELIZAOS_ROOM_ID: (Optional, but should match ELIZAOS_AGENT_ID if provided).
  4. (Optional) Adjust Advanced Settings

    • If you have custom timeout requirements, you may optionally set:
      • ELIZAOS_CONNECTION_TIMEOUT: (e.g., 120000)
      • ELIZAOS_RESPONSE_TIMEOUT: (e.g., 90000)
      • Other fields such as PORT, DEBUG, NODE_ENV, MCP_DISABLE_PINGS can generally use the defaults.
  5. Save Your Configuration and Restart Cursor

    • Save in the FastMCP connection interface.
    • Restart Cursor to ensure the new configuration is active.
  6. Start Using Your ElizaOS Integration in Cursor

    • You should now be able to use the tools that appear in Cursor (e.g., get_status, list_agents, chat_with_agent, set_agent).

Tip: If you encounter errors such as "missing required ElizaOS environment variables," double-check that you have entered the correct UUIDs and server URL.


Summary Table of Required ENVs:

ENV Name Where to find / how to set
ELIZAOS_SERVER_URL Your ElizaOS server address
ELIZAOS_USER_ID Your ElizaOS account UUID
ELIZAOS_WORLD_ID Your ElizaOS world UUID
ELIZAOS_AGENT_ID (optional) UUID of agent (from ElizaOS agent list)
ELIZAOS_ROOM_ID (optional) Must match agent ID if used (copy agent ID)

Quick Start

View on GitHub

More for AI and Machine Learning

View All →

More for Developer Tools

View All →

Report Issue

Thank you! Your issue report has been submitted successfully.