We'd encourage you to read through our Emporia MCP overview article to ensure your computer is ready to run this MCP program locally as well as ensuring you have the correct credentials available.
Setup for the Emporia MCP program with Claude Desktop only takes a few steps:
1.) First, open your Claude Desktop app.
2.) Once Claude Desktop is loaded, click on "Claude" within your computer's menu bar (upper left corner of your computer) to get to "Settings" (for the Claude Desktop program). This should open a new window on your computer with the settings available for your Claude Desktop Program.
3.) On the left-hand side of the Settings window, click "Developer". If this is your first MCP tool installed, you'll see a "getting started" view similar to below. If you already have existing MCP tools installed - you'll see a list of those displayed instead.
4.) Click "Edit Config" button towards the bottom of the screen. This will open your Finder window and will have a "claude_desktop_config.json" file highlighted. Open this file in your preferred text editor or IDE program.
Next steps may look a bit different from our example depending on which editor you use to open/save this configuration file.
The code you will copy/paste here (and edit) will depend if you're on Mac/Linux or Windows as well as if you're using your Emporia account credentials directly or through a .env file. See our MCP overview article on which "code" is appropriate for your situation. For our example below, we'll assume you're on Mac and using credentials directly. Only small adjustments would be required if using Windows or a .env file.
Once you have the configuration code pasted into the file - ensure you've replaced the "EMPORIA_ACCOUNT" and "EMPORIA_PASSWORD" fields with your Emporia account credentials.
Example Code:
{
"mcpServers":{
"emporia-mcp":{
"command":"npx",
"args":["@emporiaenergy/emporia-mcp"],
"env":{
"EMPORIA_ACCOUNT":"[email protected]",
"EMPORIA_PASWORD":"examplePassword1234"
}
}
}
}
5.) Save this configuration file before closing.
6.) Close Claude Desktop completely (make sure its not running in the background) for it to be able to reload with the newly added Emporia MCP program.
7.) Re-open Claude Desktop. On the Home screen for Claude Desktop, you should see a "filters" (tools) button within the chat window of the screen. If everything is working correctly, you should now see "emporia-mcp" listed towards the bottom of the list of available tools here.
Now you're all set to start chatting with your energy data!!