Connect Sage to your AI tools

Works with Claude, ChatGPT, Claude Code, and any tool that supports remote MCP.

In short

Add Sage in your AI tool using the address below. It takes a minute.
Sign in with the Apple Account you use for Sage, and choose what the tool may read.
A connected tool can only read. Change its access or disconnect it any time in Sage, under Settings › Connected AI tools.

Sage's address

Every tool asks for this. Copy it as is.

https://api.sage.contact/mcp

Sage is a remote MCP server (Streamable HTTP) that signs you in with OAuth. No API key, no client ID, no secret: the tool registers itself, and you approve it by signing in.

Claude

On the web or in the desktop app.

Open Settings, then Connectors (or go straight to claude.ai/customize/connectors).
Choose Add custom connector. Name it Sage and paste the address above.
Leave the detected defaults: authentication Always required, OAuth client Use Anthropic's hosted client metadata. Add no request headers.
Save, then Connect. Claude opens Sage's page: sign in with Apple, choose what Claude may read, and tap Allow. You land back in Claude, connected.
The first time Claude uses one of Sage's tools it may ask your permission; you can set each tool to Always allow under the connector's Tool permissions.

Claude Code

In a terminal:

claude mcp add --transport http --scope user sage https://api.sage.contact/mcp

Then, inside a Claude Code session, run /mcp, pick sage, and choose Authenticate. Your browser opens Sage's page to sign in and allow. --scope user makes Sage available in every project, not just the current folder.

ChatGPT and Codex

The ChatGPT desktop app, the Codex app, the Codex CLI, and the Codex extension for your editor share one list of MCP servers, so add Sage in whichever you use and it is there in all of them. In Sage, the connection is listed as Codex.

In the ChatGPT or Codex app:

Open Settings, then MCP servers (older versions say Plugins), and choose Add server.
Name it Sage, choose Streamable HTTP (not STDIO), paste the address above, and save. Restart if it asks.
Sage's page opens in your browser: sign in with Apple, choose what it may read, and Allow.

Or in a terminal, with the Codex CLI:

codex mcp add sage --url https://api.sage.contact/mcp
codex mcp login sage

Other tools

Anything that supports remote MCP over Streamable HTTP with OAuth can connect; give it the address and it will walk you through the same sign-in. A few common ones:

Cursor

// ~/.cursor/mcp.json
{ "mcpServers": { "sage": { "url": "https://api.sage.contact/mcp" } } }

VS Code

// mcp.json
{ "servers": { "sage": { "type": "http", "url": "https://api.sage.contact/mcp" } } }

Gemini CLI

gemini mcp add --transport http sage https://api.sage.contact/mcp

Tools that only run local (stdio) servers

Bridge it with mcp-remote, which handles the sign-in and speaks stdio to the tool:

npx -y mcp-remote https://api.sage.contact/mcp

What happens when you connect

Whichever tool you use, it opens the same page from Sage. It says which tool is asking and what it wants to read, and offers Sign in with Apple. Use the Apple Account you signed in to Sage with on your phone; that is how Sage knows whose record to open. Then you choose:

Access	What the tool can read	Default
Profile & values	Your name, language, time zone, and core values	On
Session notes	Titles, insights and shifts, intentions, and anything you wrote yourself during a session	On
Transcripts	Word for word, what you and Sage said	Off

Tap Allow and you are sent back to your tool, connected. The page is good for ten minutes; if it expires, start again from the tool.

You do not need your phone. Signing in works on a laptop as well as a phone.

What a connected tool can do

Read, and only read. Nothing a tool does can change or delete anything in Sage. Under the access you granted, these are its tools:

Tool	What it reads	Example prompt
`get_recent_context`	Who you are, your core values, and the notes from your latest sessions. The place tools start.	What have I been working through with Sage lately?
`get_profile`	Your name, language, and time zone.	What does Sage call me, and what language do I use?
`get_values`	Your ranked core values and the phrases you wrote for them.	Which of my values does this decision touch?
`list_sessions`	Your sessions by date: title, when, and how long.	When was my last session about work?
`search`	The sessions whose notes mention something (and transcripts, if you allowed them).	Find the sessions where I talked about my co-lead.
`get_session_notes`	The notes of one session, or several at once: title, insights and shifts, intentions, and your own notes.	Summarize my intentions from this month's sessions.
`get_transcript`	One session, word for word. Only if you turned transcripts on for that tool; otherwise it is told so, and can tell you.	What exactly did Sage ask me on Thursday?

Every read is recorded. In Sage, open Settings › Connected AI tools, then the tool, to see exactly what it read and when.

Changing access or disconnecting

In Sage, under Settings › Connected AI tools, open the tool. Switching something off applies to its very next request; switching transcripts on later works without connecting again. Disconnect cuts the tool off immediately, and you can connect it again whenever you like.

If something goes wrong

“There is no Sage account for this Apple Account.”

You signed in to Apple with a different Apple Account than the one you use in Sage. Go back to the tool, connect again, and choose the account you use on your phone.

“This connection request has expired.”

The page waits ten minutes. Start the connection again from your tool.

The tool says it cannot see transcripts

Transcripts are off unless you turn them on. In Sage, open the tool under Connected AI tools and switch Transcripts on. No need to reconnect.

The tool says Sage has no tools, or nothing comes back

In the tool, disconnect Sage and connect it again. In Sage, check that the tool is listed under Connected AI tools and what it may read.

Questions

omerekin4@gmail.com