Home

TeslaMate MCP Server

Documentation for teslamate-mcp — a Model Context Protocol server that exposes your TeslaMate PostgreSQL database to MCP-aware AI clients.

The README covers installation and a quick tour. Everything else lives here.

Pages

Page	What's in it
Tool Reference	All 35 tools, their parameters, and what each one returns
Configuration	Every environment variable, with defaults and guidance
Deployment	Docker, GHCR images, reverse proxies, and remote access
Writing Queries	Add your own query with a .sql + .toml pair
Write Tools	The opt-in charging-cost write path and its database grant
Development	Local setup, tests, linting, and how the pieces fit together

Quick orientation

• Read-only by default. Everything ships read-only. The one write tool is off unless you explicitly enable it, and it can only touch a single column — see Write Tools.
• Two transports. teslamate-mcp stdio for local clients like Claude Desktop and Cursor; teslamate-mcp http for remote deployments.
• Zero-argument calls still work. Every predefined tool gained optional filters in 0.4.0, but calling one with no arguments returns the full classic report.

Getting help

• Issues for bugs and feature requests
• CHANGELOG for what changed and when
• TeslaMate itself for questions about the underlying data