Tibber MCP

🚀 Tibber MCP Server

This is a Model Context Protocol (MCP) server designed for Tibber, a Norwegian electricity provider.

You can run this MCP server locally and access it through different hosts, such as Claude Desktop or Roo Code.

For more detailed information, please refer to my blog post:
Building a Tibber MCP Server: Connect Your AI Agent to Energy Consumption Data

🚀 Quick Start

The Tibber MCP server provides an easy way for AI agents to interact with the Tibber API and query information, such as current energy prices and energy consumption data.

✨ Features

Once connected to the MCP server, you can ask the following questions:

• "Analyze my electricity consumption data and present the typical peak hours and any other interesting patterns in an easy-to-read format."
• "When did I use the most electricity yesterday?"
• "How much electricity did I consume at 7 am yesterday?"
• "What is the current energy price?"
• "List the three cheapest time slots tomorrow."
• "Will the energy price be higher or lower tomorrow?"

🎥 Demo Video

🏗️ Architecture

📦 Installation

Requirements

• Python 3.12
• Tibber API token (You can obtain it on the Tibber Developer Portal)

Steps

1. Install uv:

   # On macOS and Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   # On Windows
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

2. Clone this repository:

   git clone https://github.com/linkcd/tibber-mcp.git
   cd tibber-mcp
   

3. Set up a Python virtual environment and install dependencies:

   uv venv --python 3.12 && source .venv/bin/activate && uv pip install --requirement pyproject.toml
   

📚 Documentation

Host Configuration

In Claude Desktop or Roo Code in VS:

{
   "mcpServers":{
      "tibber":{
         "command":"uv",
         "args":[
            "--directory",
            "[PATH-TO-ROOT-OF-THE-CLONED-TIBBER-MCP-FOLDER]",
            "run",
            "server.py"
         ],
         "env":{
            "TIBBER_API_TOKEN":"[YOUR-TIBBER-TOKEN]"
         }
      }
   }
}

⚠️ Important Note

Replace [YOUR-TIBBER-TOKEN] with your actual token. Never commit actual credentials to version control.

Debugging and Local Testing of the MCP Server

Run the server and execute the MCP Inspector on it:

npx @modelcontextprotocol/inspector

🛠️ Exposed Tools

• tibber