1
Install Vitalog
Follow Installation to start the API, web app and PostgreSQL with Docker Compose. Configure a primary API key, database password, root sign-in credentials and timezone before starting.Use your own UI and API origins. Examples such as
https://vitalog.example.com and https://vitalog-api.example.com are placeholders. This documentation site does not host your health records.2
Sign in and connect a client
Open your installation’s
/login page and sign in with its configured root email and password. In Account Settings → MCP Guide, choose your client and copy its configuration. Approve the OAuth request to connect to the API’s /mcp endpoint.For a REST script or Bearer-based MCP client, create a key in Account Settings → API Keys. Name, Permissions and Expires after are required. Choose Read-only, Edit or Administrative permissions, and 30 days, 90 days, 1 year or Never. Use Edit for logging observations. Copy the token when it is shown; it cannot be retrieved later.See MCP setup and API keys.3
Record an observation
Ask your MCP client to record a supplied observation, such as a 250 mL glass of water, with its actual date and timezone. The client can discover input schemas with
health_get_catalog before logging.For a complete REST example, see Log an observation. Every write needs an idempotency key. Reuse that key and the same arguments when retrying an uncertain response.4
Review the result
Open Daily View, select the observation’s date and expand its log. Weight Management shows weigh-ins and a 30-day graph when weight observations exist.Set your own goals through MCP or REST to add progress bars. The dashboard views health records; it does not create or edit them.
All screenshots and examples use synthetic data. Example goals illustrate the
software and are not recommended health targets.
