France Life

The first comprehensive MCP server for daily life in France.

18 AI-ready tools covering weather, health, transport, schools, admin, housing, and more — all powered by free French government APIs.

Built for AI assistants (Claude, GPT, Gemini, custom agents) that need to understand and navigate life in France.

Why This Exists

French government APIs are free but painful — each has different auth, formats, pagination, and quirks. This MCP normalizes everything into clean, AI-friendly tool calls with rich descriptions that tell the AI exactly when and how to use each tool.

Whether you're an expat trying to find a pharmacy on Sunday night, a French family checking school holidays, or a developer building the next great France-focused app — this MCP has you covered.

Quick Start

With Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "france-life": {
      "command": "npx",
      "args": ["france-life-mcp"]
    }
  }
}

Restart Claude Desktop. You now have 18 France tools available.

With npm (global install)

npm install -g france-life-mcp
france-life-mcp

From source

git clone https://github.com/giacomopilia/france-life-mcp.git
cd france-life-mcp
npm install
npm run build
npm start

Tools Reference

📍 Address & Location (2 tools)

Tool	Description
france_search_address	Geocode any French address → GPS coordinates (BAN database, 25M+ addresses)
france_reverse_geocode	GPS coordinates → nearest French address

🌦️ Weather & Environment (3 tools)

Tool	Description
france_get_weather	Forecast: temperature, rain, wind, UV index — today + 6 days
france_get_air_quality	Air quality index (AQI 1-5), PM2.5, PM10, ozone, pollen levels
france_get_water_quality	Tap water quality by commune — contaminants, compliance status

📅 Calendar & Holidays (2 tools)

Tool	Description
france_get_public_holidays	All jours fériés for any year + automatic pont (bridge day) detection
france_get_school_holidays	Vacances scolaires by zone A/B/C for any academic year

🏫 Education (1 tool)

Tool	Description
france_search_schools	Find schools by city, level (maternelle→lycée), public/private

🏥 Health (2 tools)

Tool	Description
france_search_doctors	Find doctors & specialists — with sector info (1=no extra fees, 2=extra fees possible)
france_find_pharmacies	Find pharmacies near you + pharmacie de garde tips for nights/Sundays

🚆 Transport (2 tools)

Tool	Description
france_search_stations	Find SNCF train stations by name or city
france_get_transport_disruptions	Current transport status + links to real-time sources

🏛️ Admin & Paperwork (1 tool)

Tool	Description
france_search_public_services	Find any administration: mairie, préfecture, CAF, CPAM, tribunal — with hours

🏠 Housing & Neighborhood (3 tools)

Tool	Description
france_get_property_prices	Real transaction prices from notaire records (DVF) — not estimates
france_get_natural_risks	Flood, earthquake, industrial risks for any address (Géorisques)
france_get_energy_rating	Building energy performance (DPE A-G) with rental ban info

💰 Prices (1 tool)

Tool	Description
france_get_fuel_prices	Cheapest fuel near you — real-time government data

🏢 Business (1 tool)

Tool	Description
france_search_companies	Company lookup by name/SIRET/SIREN — official SIRENE database

Example Conversations

Once connected, just talk naturally to your AI assistant:

"Is there a pharmacie open near Rueil-Malmaison?" → Uses france_find_pharmacies with postcode 92500

"When are the next school holidays? We're in zone C." → Uses france_get_school_holidays for current academic year, zone C

"How much did apartments sell for on my street last year?" → Uses france_search_address to get commune code, then france_get_property_prices

"Find a dermatologist in the 92 who doesn't charge extra fees" → Uses france_search_doctors with specialty and department filters

"Should I take an umbrella tomorrow?" → Uses france_search_address for coordinates, then france_get_weather

"Is this plumber legit? His company is called XYZ Plomberie" → Uses france_search_companies to verify registration and active status

Data Sources

All data comes from official, free, public APIs:

Source	API	Tools
Base Adresse Nationale (BAN)	api-adresse.data.gouv.fr	Address
Open-Meteo	api.open-meteo.com	Weather, Air Quality
Hub'Eau	hubeau.eaufrance.fr	Water Quality
Calendrier gouv.fr	calendrier.api.gouv.fr	Public Holidays
Éducation Nationale	data.education.gouv.fr	School Holidays, Schools
Assurance Maladie	data.ameli.fr	Doctors
FINESS	OpenDataSoft	Pharmacies
SNCF Open Data	ressources.data.sncf.com	Stations, Transport
Service-Public.fr	api-lannuaire.service-public.fr	Public Services
DVF / Cerema	apidf-preprod.cerema.fr	Property Prices
Géorisques	georisques.gouv.fr	Natural Risks
ADEME	data.ademe.fr	Energy Ratings (DPE)
Prix Carburants	data.economie.gouv.fr	Fuel Prices
Recherche Entreprises	recherche-entreprises.api.gouv.fr	Companies

No API keys required. All these APIs are free and open. Rate limits are generous (typically 50 req/sec).

Architecture

france-life-mcp/
├── src/
│   ├── index.ts              # Server entry point
│   ├── services/
│   │   └── api-client.ts     # Shared HTTP client with error handling
│   └── tools/
│       ├── address.ts        # BAN geocoding
│       ├── weather.ts        # Open-Meteo + Hub'Eau
│       ├── calendar.ts       # Holidays
│       ├── education.ts      # Schools
│       ├── health.ts         # Doctors + Pharmacies
│       ├── transport.ts      # SNCF stations
│       ├── admin.ts          # Public services
│       ├── housing.ts        # DVF + Géorisques + DPE
│       ├── prices.ts         # Fuel prices
│       └── business.ts       # SIRENE companies
├── dist/                     # Compiled JavaScript
├── package.json
├── tsconfig.json
├── LICENSE                   # MIT
└── README.md

Roadmap

v1.0 (Current) — 18 tools

Core daily life tools covering the essentials.

v2.0 (Planned)

• 🎭 Culture & Entertainment — events, movies, museums (OpenAgenda integration)
• 🍽️ Restaurants — when a good free API becomes available
• ⚖️ Legal / Légifrance — simplified French law lookup (requires PISTE registration)
• 📬 La Poste — mail tracking, postal codes
• 📊 INSEE — demographics and statistics
• 🏥 Pharmacies de garde — real-time on-duty pharmacy status

Contributing

PRs welcome! Especially for:

• New tool integrations (check the roadmap above)
• Better tool descriptions (these matter hugely for AI quality)
• Bug fixes and API endpoint updates
• Translations (tool descriptions in French)

License

MIT — use it however you want. Built with ❤️ for everyone navigating life in France.

Author

Giacomo Pilia — Italian expat in France, building AI tools for daily life.

Part of the Angie ecosystem — a personal AI assistant for life in France.