Setting up the Emporia MCP program with Cursor IDE enables you to chat with your home energy data directly within your code editor. This guide walks you through the complete setup process, from opening settings to verifying your connection.
Before starting, read through our Emporia MCP overview article to ensure your computer is ready to run this MCP program locally and that you have the correct credentials available.
Prerequisites
Before beginning setup, ensure you have:
Cursor IDE is installed on your computer
Node.js installed and verified (run
node -vin Terminal/Command Prompt)An Emporia account with email and password credentials
Your Emporia account email and password are ready
Step-by-Step Setup Process
Step 1: Open Cursor IDE
Launch the Cursor IDE program on your computer
Wait for the application to fully load
Step 2: Navigate to Cursor Settings
Click "Cursor" in your computer's menu bar (upper left corner)
Select "Settings" from the dropdown menu
Click "Cursor Settings"
A new tab (file) will open within Cursor, showing the available settings
Step 3: Access MCP Tools Settings
On the left-hand side of the Settings window, click "MCP Tools."
If you already have MCP programs installed, you should see a list of them here
If you don't have any existing MCP programs, you'll see an "Add Custom MCP" button
Step 4: Add Emporia MCP Configuration
Copy and paste the configuration code below. If you don't already have any MCP tools installed, you can paste this directly. If you already see a list of MCP tools, simply add the "emporia-mcp" code within the existing list of tools.
Configuration Code:
{ "mcpServers":{ "emporia-mcp":{ "command":"npx", "args":["@emporiaenergy/emporia-mcp"], "env":{ "EMPORIA_ACCOUNT":"[email protected]", "EMPORIA_PASSWORD":"examplePassword1234" } } } }Important: Replace [email protected] and examplePassword1234 with your actual Emporia account credentials.
Step 5: Save and Verify
Save the configuration file (Command+S on Mac or Ctrl+S on Windows)
Once saved, you should see the newly added MCP tool within your Cursor settings
If "emporia-mcp" appears in your MCP Tools list, congratulations! You're all set up and ready to chat with your Emporia data.
Testing Your Connection
Try these simple commands within Cursor's chat interface to verify everything is working:
List Your Devices:
"List my Emporia devices."
Query Recent Data:
"Show me my energy usage from yesterday."
Ask About Costs:
"How much did my EV charger cost last week?"
If these commands return data from your Emporia account, your setup is complete and working correctly.
Troubleshooting
"emporia-mcp" doesn't appear in the tools list:
Verify your configuration was saved correctly
Check that your credentials are entered exactly as shown (no typos)
Try restarting Cursor IDE completely
Verify Node.js is installed by running
node -vin Terminal
Authentication errors:
Double-check that your Emporia email and password are correct
Ensure you're using a native Emporia account (not Google/Apple sign-in)
Try creating a new native account and sharing your devices with it
MCP Tools section not visible:
Ensure you're using the latest version of Cursor IDE
Check that MCP support is enabled in your Cursor settings
Feedback and Suggestions
This knowledge base is continuously evolving to provide comprehensive support for managing your energy effectively. If you found this article unhelpful or think it could be improved, please contact our Customer Support team.