cobanov / teslamate-mcp
A Model Context Protocol (MCP) server that provides access to your TeslaMate database, allowing AI assistants to query Tesla vehicle data and analytics.
Why this job: name: mcp; says: model context protocol; topics: mcp-server, mcp
What it does
- 65 SQL report tools. A health check, battery capacity, charge cycles and degradation (per month and per km), sleep and state history, climate run while parked, a year or month in review, a timeline of each day, trips, frequent routes, range
- 10 interactive charts (MCP Apps). Charging curves (one session, or several overlaid), battery degradation, drive and trip maps with elevation profiles, a monthly or yearly activity dashboard, a year- or month-in-review card, a map of visite
- Guidance for the assistant. MCP instructions and 12 prompts map questions to tools, and get_unit_preferences lets the assistant answer in the units set in TeslaMate.
- Typed inputs and outputs. Each report tool declares its parameters and result columns in a .toml file. The server validates the declarations at startup. Parameters bind as SQL placeholders, never as string concatenation.
- Safe custom SQL. run_sql runs your SELECT inside a PostgreSQL READ ONLY transaction, with timeouts and a row cap. The transaction always rolls back.
Get started
cp env.example .env
# set DATABASE_URL, and set AUTH_TOKEN for remote use
docker compose up -dYou need: TeslaMate with its PostgreSQL database.; Python 3.11+ for a local install, or Docker for a server install.
- Maintenance
- Active
- Last commit 3 days ago
- Stars
- 142
- On GitHub
- Licence
- MIT
- Allows business use
- Downloads for
- None listed
- No release files
- Latest version
- v0.17.0
- Released 14 days ago
- Built with
- Python
- 55% of the code
Is it looked after?
- Contributors
- 4
- Last 90 days
- Issues
- 100% closed
- 0 still open
- Pull requests
- 14 merged
- 0 waiting
- Releases
- 7
- 7 in the last year
- Contributing guide (opens in new tab)
- Security policy (opens in new tab)
- No code of conduct
More: languages, topics and project record
Languages
- Python 55%
- HTML 43%
- JavaScript 1%
- CSS <1%
Topics
- mcp
- mcp-server
- tesla
- tesla-api
- teslamate
Project record
- JobMCP servers
- StatusListed
- Commits162
- Forks24
- Watching2
- Stars in 28 days+1
- CreatedJun 8, 2025
- First seen by usNov 7, 2026
- CheckedNov 7, 2026