Connect your AI
Copy this prompt and paste it into ChatGPT or Claude. Your AI shows you where to tap.
Help me connect one-by.one to you. It's a custom connector named one-by.one at https://mcp.one-by.one/mcp. Tell me exactly where to tap to add it on this device, one step at a time. I'll sign in and tap Allow, then go back to the one-by.one app.Sign in with the same one-by.one account as on your iPhone and tap Allow. Then go back to the app.
Teach your AI the habit
Paste this into Claude or ChatGPT once.
Please remember this for all our chats: I run my day in one-by.one. Whenever I mention something I did or still need to do, even loosely, update one-by.one right away (done → record it, to do → add or change the card), then tell me my next card in one line. If you can add skills, also add the one-by.one skill from https://one-by.one/skill/one-by-one/SKILL.md.How it works
Your AI adds one-by.one as a connector; you sign in to your one-by.one account in the browser and approve the access. An AI can’t add a connector by itself, so it tells you where to tap. You can connect up to 3 apps. To disconnect one, tap Disconnect in Settings › AI apps in the iPhone app.
Permissions
The app can:
context:read— read the context you share for planning.activity:read— read your plans and recorded activity.activity:write— create or update plans and save activity.
An app we have not verified shows as Unverified app on the approval screen; check it is the one you meant to connect. The Privacy Policy covers what your AI receives.
For developer tools
Claude Code, Codex, Cursor and other MCP apps take the server URL directly.
https://mcp.one-by.one/mcpStreamable HTTP, OAuth sign-in. No API key or token.
Set up your app
Merge only the onebyone entry into your existing settings. No tokens or client secrets are needed. Menus vary by version.
ChatGPT · Apps / Connectors
- Turn on Developer mode if your account allows it (Settings → Security and login → Developer mode).
- Open Plugins, select +, name it one-by.one and enter
https://mcp.one-by.one/mcp. Older versions call this Apps or Connectors. - Finish the sign-in, then pick it from the tools menu in a new chat. Availability depends on your plan and workspace policy.
Claude · claude.ai / Desktop
- Open Customize → Connectors and add a custom web connector.
- Name it one-by.one and enter
https://mcp.one-by.one/mcp. - Choose sign-in authentication and automatic client registration if shown, finish the sign-in, then enable the connector in your conversation.
Claude Desktop uses the same connector. Team and Enterprise workspaces may need an owner to add it first.
Claude Code
Run in your terminal:
claude mcp add --transport http onebyone https://mcp.one-by.one/mcpThen run /mcp in a session, select onebyone and authenticate in the browser.
Codex CLI
Add the server and sign in:
codex mcp add onebyone --url https://mcp.one-by.one/mcp
codex mcp login onebyoneOr add this to ~/.codex/config.toml and run codex mcp login onebyone:
[mcp_servers.onebyone]
url = "https://mcp.one-by.one/mcp"Check the connection with /mcp in Codex.
Cursor
Add this to .cursor/mcp.json (project) or ~/.cursor/mcp.json (all projects):
{
"mcpServers": {
"onebyone": {
"url": "https://mcp.one-by.one/mcp"
}
}
}Restart Cursor, complete the sign-in prompt and use the tools in Agent.
VS Code · GitHub Copilot
Add this to .vscode/mcp.json, or open user settings with MCP: Open User Configuration:
{
"servers": {
"onebyone": {
"type": "http",
"url": "https://mcp.one-by.one/mcp"
}
}
}Start onebyone from the editor, sign in in the browser and enable its tools in Copilot Agent.
Gemini CLI
Add this to ~/.gemini/settings.json or the project’s .gemini/settings.json. OAuth is discovered automatically.
{
"mcpServers": {
"onebyone": {
"httpUrl": "https://mcp.one-by.one/mcp"
}
}
}Then, in a Gemini CLI session:
/mcp auth onebyoneWindsurf / Cascade
In Cascade, open the … Actions menu → MCPs → Open MCP config file. Add this to mcp_config.json and sign in when prompted:
{
"mcpServers": {
"onebyone": {
"serverUrl": "https://mcp.one-by.one/mcp"
}
}
}The official Windsurf guide now redirects to Devin Desktop and covers the legacy Cascade agent. Newer Devin Local tabs use a different setup.
Other MCP apps
Use the same URL with remote Streamable HTTP and OAuth. The app must support OAuth discovery and dynamic client registration; local tools can use a loopback redirect. Agents can read this page as Markdown.
Example prompts
After connecting, try:
- “Here is my week: I work 9 to 6 Monday to Friday, and I have a dentist visit Thursday at 4. Plan it, including getting there and back.”
- “I am behind today. Lighten the rest of the day and move what can wait.”
- “I just walked for 20 minutes and read for half an hour. Record that.”
- “Look at what I actually did last week and tell me what to change this week.”
Troubleshooting
- The sign-in page does not open.
- Your app must support OAuth sign-in with automatic client registration. Remove the connection, add it again and retry.
- The limit of 3 connections is reached.
- Disconnect one you no longer use in Settings › AI apps in the iPhone app, then connect again.
- The tools do not appear in a chat.
- Turn the connector on for that conversation, or start a new chat.
- Access is refused after sign-in.
- AI connections need your account’s subscription access. Check it in the iPhone app.
- Cards do not show on the iPhone.
- Make sure the iPhone app and your AI app are signed in to the same one-by.one account.
Still stuck? Contact support.
Disconnecting
You can also use Disconnect on the connection’s authorization page, or remove it in the AI app. This stops future access; it does not delete your one-by.one records or what the AI already received. AI connections require your account’s applicable subscription entitlement.
Prompt for your AI agent
Paste this into your agent to add the server and start the sign-in.
Add the one-by.one MCP server to yourself and connect it.
- Server URL: https://mcp.one-by.one/mcp
- Transport: remote streamable HTTP. Name the server "onebyone".
- Auth: OAuth sign-in with dynamic client registration. There is no API key or token, so do not ask me for one.
Steps:
1. Add the server to your MCP configuration and keep my existing servers. If you cannot change your own configuration, give me the exact command or setting for this client.
2. Start the OAuth sign-in. If you cannot open a browser, show me the sign-in link.
3. I will sign in to my one-by.one account and approve the permissions: context:read, activity:read and activity:write. The approval screen may label you "Unverified app"; that is normal for unverified clients.
4. When I am back, confirm that the onebyone tools are listed. Do not create or change any plans until I ask. If the connection is refused because the limit of 3 AI connections is reached, tell me.
Instructions for each client: https://one-by.one/connect/index.md