What are the requirements for Aedifion?

Aedifion requires the following environment variables: AEDIFION_USERNAME (required), AEDIFION_PASSWORD (required), AEDIFION_TOKEN (optional), AEDIFION_BASE_URL (optional). You'll also need a compatible MCP client like Claude Desktop or Claude Code.

Is Aedifion free to use?

Yes, Aedifion is open source and free to use. You can find the source code on GitHub.

What MCP clients support Aedifion?

Aedifion works with any MCP-compatible client including Claude Desktop (Anthropic's official desktop app), Claude Code (CLI tool), Cursor, and other editors with MCP support.

How do I configure Aedifion?

Configure Aedifion by adding it to your MCP client's config file. For Claude Desktop, edit claude_desktop_config.json and add the server configuration. See the Configuration section above for a ready-to-use example.

Aedifion MCP Server

Q: What tools does Aedifion provide?

ping: Check API server availability. get_api_version: Get the aedifion API version. get_endpoints: List all available API endpoints. get_user: Get current user details. ai_chat: Send a message to the aedifion AI assistant. get_project_datapoints: List datapoints with optional filtering. get_project_timeseries: Get timeseries data for multiple datapoints.

Q: How do I install Aedifion?

Install Aedifion by running: uv pip install git+https://github.com/tookta/mcp-server-aedifion.git

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal

uv pip install git+https://github.com/tookta/mcp-server-aedifion.git

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal

claude mcp add -e "AEDIFION_USERNAME=${AEDIFION_USERNAME}" -e "AEDIFION_PASSWORD=${AEDIFION_PASSWORD}" aedifion -- node "<FULL_PATH_TO_MCP_SERVER_AEDIFION>/dist/index.js"

Replace <FULL_PATH_TO_MCP_SERVER_AEDIFION>/dist/index.js with the actual folder you prepared in step 1.

Required:AEDIFION_USERNAMEAEDIFION_PASSWORD+ 2 optional

README.md

Interact with the aedifion cloud platform for building performance optimization.

mcp-server-aedifion

An MCP (Model Context Protocol) server that provides tools for interacting with the aedifion cloud API. This server enables AI assistants (Claude, etc.) to manage building IoT data, analytics, controls, and more through the aedifion platform.

What is aedifion?

aedifion provides a cloud platform for building performance optimization. Their API offers access to:

Building IoT data — datapoints, timeseries, setpoints
Analytics — automated analysis functions, KPI tracking, energy efficiency monitoring
Controls — remote building control apps
Project management — components, tags, labels, logbooks, tasks, alerts
Weather data — current conditions and forecasts for building locations

API documentation: https://api.cloud.aedifion.eu/ui/

Installation

Using `uv` (recommended)

uv pip install git+https://github.com/tookta/mcp-server-aedifion.git

Using `pip`

pip install git+https://github.com/tookta/mcp-server-aedifion.git

From source

git clone https://github.com/tookta/mcp-server-aedifion.git
cd mcp-server-aedifion
uv pip install -e .

Configuration

Environment variables

The server requires aedifion API credentials. Create a .env file in your working directory (see .env.example):

cp .env.example .env
# Edit .env with your credentials

Variable	Required	Default	Description
`AEDIFION_USERNAME`	Yes*	—	Your aedifion account email
`AEDIFION_PASSWORD`	Yes*	—	Your aedifion account password
`AEDIFION_TOKEN`	No	—	Pre-obtained bearer token (alternative to username/password)
`AEDIFION_BASE_URL`	No	`https://api.cloud.aedifion.eu`	API base URL

* Required unless AEDIFION_TOKEN is set.

Claude Desktop

Add the server to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "aedifion": {
      "command": "mcp-server-aedifion",
      "env": {
        "AEDIFION_USERNAME": "your-email@example.com",
        "AEDIFION_PASSWORD": "your-password"
      }
    }
  }
}

Or if running from source with uv:

{
  "mcpServers": {
    "aedifion": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/mcp-server-aedifion",
        "run", "mcp-server-aedifion"
      ],
      "env": {
        "AEDIFION_USERNAME": "your-email@example.com",
        "AEDIFION_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code

Add the server to your Claude Code settings:

claude mcp add aedifion -- mcp-server-aedifion

Or with environment variables:

claude mcp add aedifion --env AEDIFION_USERNAME=your-email --env AEDIFION_PASSWORD=your-password -- mcp-server-aedifion

Available tools

The server exposes 95+ tools organized by category, covering all major areas of the aedifion API.

Tool	Description
`ping`	Check API server availability
`get_api_version`	Get the aedifion API version
`get_endpoints`	List all available API endpoints
`get_label_definitions`	Get all label definitions
`get_label_systems`	Get available unit/label systems (SI, imperial, etc.)

User

Tool	Description
`get_user`	Get current user details
`update_user`	Update user profile (first name, last name)
`get_user_permissions`	Get user's project permissions
`get_user_roles`	Get user's assigned roles

AI assistant

Tool	Description
`ai_get_threads`	List AI conversation threads
`ai_get_thread`	Get messages in a thread
`ai_chat`	Send a message to the aedifion AI assistant
`ai_delete_thread`	Delete a conversation thread

Company

Tool	Description
`get_company`	Get company details with projects and users
`update_company`	Update company name/description
`get_company_roles`	List company roles
`get_company_permissions`	List company project permissions
`get_company_labels`	List company labels
`create_project`	Create a new project
`create_user`	Create a new user
`get_company_user`	Get user details
`delete_company_user`	Delete a user

Realm

Tool	Description
`get_realm_companies`	List all companies in the realm
`get_realm_projects`	List all projects in the realm
`get_realm_users`	List all users in the realm

Project

Tool	Description
`get_project`	Get project details
`update_project`	Update project name/description
`delete_project`	Delete a project (requires name confirmation)
`get_project_datapoints`	List datapoints with optional filtering
`get_project_timeseries`	Get timeseries data for multiple datapoints
`write_project_timeseries`	Write timeseries data
`delete_p

Tools (7)

pingCheck API server availability

get_api_versionGet the aedifion API version

get_endpointsList all available API endpoints

get_userGet current user details

ai_chatSend a message to the aedifion AI assistant

get_project_datapointsList datapoints with optional filtering

get_project_timeseriesGet timeseries data for multiple datapoints

Environment Variables

AEDIFION_USERNAMErequiredYour aedifion account email

AEDIFION_PASSWORDrequiredYour aedifion account password

AEDIFION_TOKENPre-obtained bearer token

AEDIFION_BASE_URLAPI base URL

Configuration

claude_desktop_config.json

{"mcpServers": {"aedifion": {"command": "mcp-server-aedifion", "env": {"AEDIFION_USERNAME": "your-email@example.com", "AEDIFION_PASSWORD": "your-password"}}}}

Try it

→List all datapoints available in my current building project.

→Get the latest energy consumption timeseries data for the main HVAC system.

→Check the current status of the building's IoT connection using the ping tool.

→Retrieve the list of active conversation threads from the aedifion AI assistant.

Frequently Asked Questions

What are the key features of Aedifion?

Access to building IoT data including datapoints, timeseries, and setpoints.. Automated analytics for KPI tracking and energy efficiency monitoring.. Remote building control capabilities via integrated apps.. Comprehensive project management for components, tasks, and alerts.. Integration with weather data forecasts for building locations..

What can I use Aedifion for?

Optimizing building energy performance by analyzing real-time sensor data.. Automating the monitoring of building IoT infrastructure and alerts.. Managing project-specific tasks and logbooks directly through AI assistants.. Retrieving historical timeseries data for energy efficiency reporting..

How do I install Aedifion?

Install Aedifion by running: uv pip install git+https://github.com/tookta/mcp-server-aedifion.git

What MCP clients work with Aedifion?

Aedifion works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Aedifion docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.

Open Conare

View all cloud servers →

Aedifion MCP Server

Set the server up locally

Register it in Claude Code

mcp-server-aedifion

What is aedifion?

Installation

Using `uv` (recommended)

Using `pip`

From source

Configuration

Environment variables

Claude Desktop

Claude Code

Available tools

Meta

User

AI assistant

Company

Realm

Project

Tools (7)

Environment Variables

Configuration

Try it

Frequently Asked Questions

Turn this server into reusable context

Related MCP Servers