Feelments guide

Connect your AI. Read and save your records.

Read records you entered in Feelments from your assistant, or save records while you talk. Both use your own, shared ledger.

Connect

Add Feelments to your assistant using the steps below.

Ask simply

Copy an example prompt. Start by reading your records.

Check the result

Read a saved record back and check it in Timeline.

Choose your assistant

Use this same URL for each assistant, authorize the same Feelments account, and enable Feelments in the conversation.

https://feelments.com/api/mcp

ChatGPT

Paid web plans, using Developer mode. Organization settings may restrict access.

In Settings → Security and login, enable Developer mode.
At chatgpt.com/plugins, use + to create an app with the connection URL below and OAuth authentication.
Sign in to Feelments and allow access. In a conversation, choose + → Developer mode → Feelments, then send an example prompt.

Official setup instructions ↗

Claude

Free allows one custom connector. Team and Enterprise require an organization owner to add it.

Open Customize → Connectors → + → Add custom connector.
Add the connection URL below, then Connect and authorize your Feelments account.
Enable Feelments in the conversation's + → Connectors menu, then send an example prompt.

Official setup instructions ↗

Claude Code

Under review: Claude Code 2.1.261 fails OAuth with invalid_redirect at the callback. A successful connection has not been verified.

Run the commands below to add the HTTP server and start login.
Sign in to Feelments in the browser and authorize access.
Open Claude Code, check /mcp, and send an example prompt.

claude mcp add --transport http feelments https://feelments.com/api/mcp claude mcp login feelments

Official setup instructions ↗

Codex

DCR OAuth verified locally with Codex CLI 0.153.4. Tool use from real conversations and app/IDE connections still need verification.

Run the commands below to add the server and start OAuth login.
Authorize the same Feelments account you use with your other assistants.
Open Codex, check /mcp, and name Feelments in your prompt.

codex mcp add feelments --url https://feelments.com/api/mcp codex mcp login feelments --oauth-client-registration dcr

Official setup instructions ↗

Gemini / Spark

Limited to eligible Spark users in the US, age 18+, personal Google accounts, English, with Keep Activity on. General Gemini availability is not verified.

If eligible, open Gemini → Settings & help → Connected Apps.
Add the connection URL under Custom apps for Spark and authorize Feelments.
Select Feelments with @ in a Spark task. If this setting is unavailable, copy your brief from Memory instead.

Official setup instructions ↗

Gemini CLI

Separate from Gemini web/mobile. HTTP/OAuth setup is documented; authenticated interoperability with Feelments is not yet verified.

Add the server with the command below.
Inside Gemini CLI, run /mcp auth feelments and authorize Feelments.
Check /mcp list and start with a read-only example prompt.

gemini mcp add --transport http feelments https://feelments.com/api/mcp

Official setup instructions ↗

Instructions checked 2026-09-06. Menus and availability can change. Feelments read/write communication has been tested; actual conversations in each assistant still need individual verification.

Copy a prompt and ask

Read first

Read my current records from Feelments and give me a short summary.

Fetches your brief, including when you have no records yet.

Read what you logged in the app

Show me last week's records from Feelments.

Reads the same dated ledger used by the web app, devices and assistants.

Save from a conversation

I walked for 20 minutes today. Save it to Feelments and check the saved record.

Adds the habit, then reads the day back.

Save how you felt

My sleep today was a little better than usual. Record that in Feelments.

Saves your daily sleep rating. Ask the assistant to clarify an ambiguous rating.

Continue with another assistant

Show me the walk I just saved for today in Feelments.

Use the same Feelments account to read records saved by another assistant.

Organize past messages

Propose health records from this conversation in Feelments and give me the review link.

Saves proposals. They enter your ledger only after you review and confirm them.

If the assistant answers without using tools, ask it to actually read using the Feelments tools. Review any write confirmation. Connecting alone does not automatically save conversations or import every past chat.

Verify that it was saved

Ask for today's Feelments records and check the date, item and amount in the actual tool result.
Timeline shows the same record. Refresh a screen that was already open.
Authorize the same Feelments account in another assistant and read that day. The ledger is shared; conversations are not transferred.

Proposals, corrections and removal

For bulk proposals from past messages, open the returned link and confirm. A proposal is not a saved ledger entry. The assistant can only propose from content available in its conversation.

Logging the same item on the same day again preserves its existing amount and time. Correct intake details or delete notes and measurements in Feelments. Assistants can update daily ratings and stop or resume experiments.

Revoke an assistant from Connections to stop its access. Previously saved records remain.

Manage connections Copy a brief without connecting

Loading…

Choose your assistant

Use this same URL for each assistant, authorize the same Feelments account, and enable Feelments in the conversation.

https://feelments.com/api/mcp

ChatGPT

Paid web plans, using Developer mode. Organization settings may restrict access.

In Settings → Security and login, enable Developer mode.
At chatgpt.com/plugins, use + to create an app with the connection URL below and OAuth authentication.
Sign in to Feelments and allow access. In a conversation, choose + → Developer mode → Feelments, then send an example prompt.

Official setup instructions ↗

Claude

Free allows one custom connector. Team and Enterprise require an organization owner to add it.

Open Customize → Connectors → + → Add custom connector.
Add the connection URL below, then Connect and authorize your Feelments account.
Enable Feelments in the conversation's + → Connectors menu, then send an example prompt.

Official setup instructions ↗

Claude Code

Under review: Claude Code 2.1.261 fails OAuth with invalid_redirect at the callback. A successful connection has not been verified.

Run the commands below to add the HTTP server and start login.
Sign in to Feelments in the browser and authorize access.
Open Claude Code, check /mcp, and send an example prompt.

claude mcp add --transport http feelments https://feelments.com/api/mcp claude mcp login feelments

Official setup instructions ↗

Codex

DCR OAuth verified locally with Codex CLI 0.153.4. Tool use from real conversations and app/IDE connections still need verification.

Run the commands below to add the server and start OAuth login.
Authorize the same Feelments account you use with your other assistants.
Open Codex, check /mcp, and name Feelments in your prompt.

codex mcp add feelments --url https://feelments.com/api/mcp codex mcp login feelments --oauth-client-registration dcr

Official setup instructions ↗

Gemini / Spark

Limited to eligible Spark users in the US, age 18+, personal Google accounts, English, with Keep Activity on. General Gemini availability is not verified.

If eligible, open Gemini → Settings & help → Connected Apps.
Add the connection URL under Custom apps for Spark and authorize Feelments.
Select Feelments with @ in a Spark task. If this setting is unavailable, copy your brief from Memory instead.

Official setup instructions ↗

Gemini CLI

Separate from Gemini web/mobile. HTTP/OAuth setup is documented; authenticated interoperability with Feelments is not yet verified.

Add the server with the command below.
Inside Gemini CLI, run /mcp auth feelments and authorize Feelments.
Check /mcp list and start with a read-only example prompt.

gemini mcp add --transport http feelments https://feelments.com/api/mcp

Official setup instructions ↗

Instructions checked 2026-09-06. Menus and availability can change. Feelments read/write communication has been tested; actual conversations in each assistant still need individual verification.

Copy a prompt and ask

Read first

Read my current records from Feelments and give me a short summary.

Fetches your brief, including when you have no records yet.

Read what you logged in the app

Show me last week's records from Feelments.

Reads the same dated ledger used by the web app, devices and assistants.

Save from a conversation

I walked for 20 minutes today. Save it to Feelments and check the saved record.

Adds the habit, then reads the day back.

Save how you felt

My sleep today was a little better than usual. Record that in Feelments.

Saves your daily sleep rating. Ask the assistant to clarify an ambiguous rating.

Continue with another assistant

Show me the walk I just saved for today in Feelments.

Use the same Feelments account to read records saved by another assistant.

Organize past messages

Propose health records from this conversation in Feelments and give me the review link.

Saves proposals. They enter your ledger only after you review and confirm them.

Verify that it was saved

Ask for today's Feelments records and check the date, item and amount in the actual tool result.

Timeline shows the same record. Refresh a screen that was already open.

Authorize the same Feelments account in another assistant and read that day. The ledger is shared; conversations are not transferred.

Proposals, corrections and removal

For bulk proposals from past messages, open the returned link and confirm. A proposal is not a saved ledger entry. The assistant can only propose from content available in its conversation.

Revoke an assistant from Connections to stop its access. Previously saved records remain.