# LifeButler API

> REST API and MCP server for LifeButler, the family and group organiser for Germany, Austria and Switzerland: calendar, tasks, lists, documents, smart search and the AI butler. Pro and Premium plans; only owners and admins of a workspace; times in Europe/Berlin.

- Base URL: https://api.lifebutler.io/v1
- MCP server: https://api.lifebutler.io/mcp (Streamable HTTP, Bearer key)
- Auth: Authorization: Bearer lb_live_… (created in the app: Settings → API & MCP)
- OpenAPI 3.1: https://lifebutler.io/developers/openapi.json

Every page is Markdown at the URL below; drop ".md" for the HTML page.

## Getting started

- [LifeButler API](https://lifebutler.io/developers.md): Read and change your LifeButler workspaces from your own code, automations and AI assistants – REST API and MCP server.
- [Authentication](https://lifebutler.io/developers/authentication.md): API keys, how to send them, scopes, expiry and revocation.
- [Workspaces, roles & security](https://lifebutler.io/developers/access.md): Which data a key can reach, who may use the API, plan limits, and what other members see.
- [Conventions](https://lifebutler.io/developers/conventions.md): Times and time zones, IDs, paging, errors, rate limits and AI credits.

## AI assistants

- [MCP server](https://lifebutler.io/developers/mcp.md): Connect Claude, ChatGPT, Cursor, VS Code and other AI assistants to LifeButler with the Model Context Protocol.
- [Prompt for your AI coding assistant](https://lifebutler.io/developers/llm-prompt.md): A ready-made prompt that teaches Claude Code, Codex, Cursor, Copilot or Windsurf how to build with the LifeButler API.

## Guides

- [Recipes](https://lifebutler.io/developers/recipes.md): Short, complete examples – shopping list from Home Assistant, calendar import, scanning folder, weekly digest.

## API reference

- [Overview](https://lifebutler.io/developers/reference.md): all endpoints
- [Workspaces](https://lifebutler.io/developers/reference/workspaces.md): The workspaces a key may use, and their members.
- [Calendar](https://lifebutler.io/developers/reference/calendar.md): Appointments, including repeating ones.
- [Tasks](https://lifebutler.io/developers/reference/tasks.md): To-dos with exact or fuzzy due dates, assignees and repetition.
- [Lists](https://lifebutler.io/developers/reference/lists.md): Shopping and to-do lists and their items.
- [Documents](https://lifebutler.io/developers/reference/documents.md): Stored files with their AI analysis: search, upload, download.
- [Search & Butler](https://lifebutler.io/developers/reference/search-and-butler.md): Smart search by meaning and the AI butler.

## Support

- hallo@lifebutler.io