Docs · MCP

Connect Emira to your AI assistant.

Emira runs a remote MCP server. Any OAuth-capable MCP client can read your daily totals and write entries into your journal, using the same account as the mobile app.

Setup

Three steps, and no key to copy anywhere. If your client supports MCP over OAuth, this is all of it.

  1. Add the server

    https://www.emira-foodjournal.com/mcp
  2. Sign in

    The same credentials you use in the Emira app. No separate account.

  3. Approve the access

    A consent screen lists exactly what is being granted. Access tokens and authorisation codes are stored only as hashes.

Available tools

Five, deliberately. There is no delete tool.

How to phrase a request

An assistant will happily log something vague. These five patterns cover almost every case where an entry ends up wrong, and each one is a one-word change in habit.

State the amount, not just the food

Do Log 180 g chicken breast, 200 g rice and a tablespoon of olive oil for lunch.

Instead of Log chicken and rice.

Portion size is the single largest source of error in food logging. A stated amount is used as given; an unstated one has to be estimated.

Name the product when it matters

Do Log 150 g of Skyr, the plain 0.2 % one.

Instead of Log some yoghurt.

‘Yoghurt’ spans roughly 45 to 130 kcal per 100 g. Naming the product moves the entry from an estimate to a database match.

Say when, if it was not now

Do Log the pasta I had at 8pm yesterday.

Instead of Log the pasta from yesterday.

Entries belong to a day and a time. Being explicit avoids an entry landing on today by default and skewing two days at once.

Correct rather than re-log

Do That last entry was 300 g of rice, not 200 g.

Instead of Log 300 g rice.

A correction updates the existing entry. Logging again leaves both in your day, which is the most common way a total silently doubles.

Ask before you assume

Do How much protein have I had today, and what is left against my goal?

Instead of Am I doing well today?

The assistant can read your totals and goals directly. A specific question gets a number from your journal instead of an opinion.

What this is good at, and what it is not

An assistant is an excellent way to describe a meal and a poor place to keep a record. It has no daily total, no history you can look back at, and no product database to consult. It recalls rather than retrieves.

Connecting Emira splits those jobs properly: the assistant handles the language, Emira handles lookup, arithmetic and memory. For the reasoning behind that, see the assistant page; for what else Emira connects to, see integrations.

Questions people ask

What is the Emira MCP server URL?
https://www.emira-foodjournal.com/mcp. Add it in any MCP client that supports OAuth, then sign in with the same account you use in the app.Why this exists
Do I need an API key?
No. Authentication runs through OAuth with a consent screen. Tokens are issued to the client and stored only as hashes on our side.
Can the assistant delete my entries?
No. The available tools read your data, create an entry and update an entry. There is no delete tool.Privacy details
Will entries logged this way appear in the app?
Yes, immediately, as ordinary entries in the right day. You can edit them in the app like anything else.How entries show up later