Sohki docs
Connect an AI
Chat apps
Claude
Set up Sohki on a laptop or desktop computer. These setup steps don’t work on a phone or tablet.
- Open Add custom connector in Claude.Open
- Name it Sohki, paste this server URL, then select Continue.
https://mcp.sohki.ai/mcp - Keep the default options, and select Add. Then select Connect.
- Enter your email. Enter the code from your email and select Sign in.
- Select Allow connection. You return to Claude, connected to Sohki.
- Start a new chat and check your connection.
“Check my Sohki account.”
Free Claude accounts can add one custom connector. On a Team or Enterprise account, an owner may need to enable custom connectors first. See Claude’s setup help.
ChatGPT
Set up Sohki on a laptop or desktop computer. These setup steps don’t work on a phone or tablet.
- Open Plugins, select Add, then Add custom MCP server.Open
- Name it Sohki. Paste this server URL, and keep OAuth for Authentication.
https://mcp.sohki.ai/mcp - Check I understand and want to continue, then select Create as a plugin. Creating it can take a little while.
- Select Connect Sohki.
- Sign in to Sohki with the code sent to your email if asked, then select Allow connection. You return to ChatGPT, connected to Sohki.
- Start a new chat and check your connection.
“Check my Sohki account.”
Gemini
Set up Sohki on a laptop or desktop computer. These setup steps don’t work on a phone or tablet.
- Open Connected Apps in Gemini, then select Custom.Open
- Paste this server URL as the MCP Server URL, then select Next. Leave Additional settings as they are.
https://mcp.sohki.ai/mcp - Check I understand and accept the security and privacy risks, then select Connect.
- Select Agree and continue to link your Google Account with Sohki.
- Sign in to Sohki with the code sent to your email if asked, then select Allow connection.
- Back in Gemini, select Connect to save the app as Sohki Mcp.
- Start a new chat, type @, choose Sohki Mcp, and check your connection. If Gemini first asks about connecting its Google apps, that’s separate from Sohki; choose what you like.
“@Sohki Mcp check my Sohki account.”
Gemini custom apps need a personal Google Account, not a work or school one. You must be 18 or older and in the US, with Keep Activity turned on. See Gemini’s custom app help.
Grok
Set up Sohki on a laptop or desktop computer. These setup steps don’t work on a phone or tablet.
- Open Connectors in Grok, select New Connector, then Custom.Open
- Name it Sohki, paste this server URL, then select Add Connector.
https://mcp.sohki.ai/mcp - Sign in to Sohki with the code sent to your email if asked, then select Allow connection. You return to Grok, connected to Sohki.
- Start a new chat and check your connection.
“Check my Sohki account.”
Connectors work on every Grok plan. On a Grok Business or Enterprise account, a team admin needs to add Sohki in the xAI console first. See Grok’s connector help.
Muse
Set up Sohki on a laptop or desktop computer. These setup steps don’t work on a phone or tablet.
- Open Muse. You add Sohki by chatting with Muse, not from a settings page.Open
- Send Muse this message.
Add a custom connector named Sohki. Server URL: https://mcp.sohki.ai/mcp. It signs in with OAuth. - Muse builds the connector, which can take a minute. If it asks to share information with mcp.sohki.ai, select Always allow this site.
- Select Connect on the Sohki card, then Connect again.
- Sign in to Sohki with the code sent to your email if asked, then select Allow connection. You return to Muse, connected to Sohki.
- Muse checks the connection itself. If it doesn’t, ask it.
“Check my Sohki account.”
Muse isn’t available in every country yet. See Meta’s help on Muse connectors.
Terminal CLIs
Using a CLI that isn’t listed? Sohki answers at https://mcp.sohki.ai/mcp, so any terminal CLI that lets you add an MCP server may work with it. We haven’t tested those.
Claude Code
- Add Sohki for your user account.
claude mcp add --transport http --scope user sohki https://mcp.sohki.ai/mcp - Start Claude Code.
claude - Open the MCP servers list from inside Claude Code.
/mcp - Select sohki, then Authenticate. Sign in to Sohki with the code sent to your email if asked, then select Allow connection.
Codex CLI
- Run this command once in your terminal.
codex mcp add sohki --url https://mcp.sohki.ai/mcp - Verify that Sohki is connected.
codex mcp list
Gemini CLI
- Add Sohki for your user account.
gemini mcp add --transport http --scope user sohki https://mcp.sohki.ai/mcp - Start Gemini.
gemini - Authenticate the OAuth connection from inside Gemini. Sign in to Sohki with the code sent to your email if asked, then select Allow connection.
/mcp auth sohki - Confirm that the server is connected, still inside Gemini.
/mcp list
Grok CLI
- Run this command once in your terminal.
grok mcp add --transport http sohki https://mcp.sohki.ai/mcp - Start Grok.
grok - Open the MCP servers panel.
/mcps - Select sohki, marked needs auth. Sign in to Sohki with the code sent to your email if asked, then select Allow connection.
Muse Code
- Install Muse Code, then restart your terminal so the installer’s
~/.local/binis on your PATH.curl https://dev.meta.ai/install.sh | bash - Add Sohki to your Muse settings file at
~/.config/muse/settings.json, creating the file if it isn’t there yet. Leave every other key in the file as it is.{ "mcpServers": { "sohki": { "url": "https://mcp.sohki.ai/mcp" } } } - Run this command, then press Enter to open your browser. Sign in to Sohki with the code sent to your email if asked, then select Allow connection. Muse then replies
Logged in to MCP server `sohki`.muse mcp login sohki --callback-port 8181 - Start Muse.
muse - Confirm the connection from inside Muse. The MCP tools panel lists sohki as connected, along with the Sohki tools it brings.
/mcp
Muse Code runs on macOS and Linux and needs curl and bash. See Meta’s Muse Code docs.
Switch accounts
A chat app uses the Sohki account you signed in with when you connected it. To use another account, reconnect Sohki in that app. A new email creates its own Sohki account. Your notes stay with each account, and other chat apps keep the account they were connected with.
Claude
- In Customize → Connectors, select Sohki, disconnect it, then connect it again.
- If Sohki asks Which account?, select Use another account. Then sign in with the other email.
ChatGPT
- In Plugins (chatgpt.com/plugins), open Sohki under Created by you and uninstall it, then select Install plugin. Sohki stays listed while uninstalled.
- If Sohki asks Which account?, select Use another account. Then sign in with the other email.
Gemini
- In Settings → Connected Apps (gemini.google.com/apps), under Custom apps, select More details on Sohki Mcp, then Remove app. Add Sohki again with the Gemini steps. Turning the app’s switch off isn’t enough: Gemini keeps the same account.
- If Sohki asks Which account?, select Use another account. Then sign in with the other email.
Grok
- In Connectors (grok.com/connectors), disconnect Sohki, then connect it again.
- If Sohki asks Which account?, select Use another account. Then sign in with the other email.
Muse
- Ask Muse to reconnect Sohki with another account, then select Connect on the Sohki card. Or, in Settings → Connectors, disconnect Sohki, then connect it again.
- If Sohki asks Which account?, select Use another account. Then sign in with the other email.
Commands
Once Sohki is connected, just talk to your AI. It picks the right tool for what you say. Mention Sohki so your AI knows to use it.
Most tools use one call from your weekly allowance. Tools marked Free never use a call and still work after your calls run out: checking your account and progress, correcting how an answer was assessed, removing tags, and deleting notes or tags.
Notes
create_note- Save one note from the conversation, with its meaning, context and any tags you choose.
- “Save la mariposa to Sohki. It means butterfly.”
create_notes- Save a list of notes at once, up to 50 in each batch.
- “Save these ten Spanish words to Sohki.”
find_notes- Search your notes, or browse the most recent ones, optionally by tag.
- “What have I saved in Sohki about compound interest?”
read_note- Read a saved note in full, with its context and memory hooks.
- “Show me my Sohki note on Hanlon’s razor.”
append_to_note- Add to a note, such as a new example or memory hook, without changing what is there.
- “Add this example to my mariposa note in Sohki.”
update_note- Make an edit you ask for, such as a new title or a fixed wording.
- “Rename my Sohki note ARR to Annual recurring revenue.”
delete_noteFree- Delete one note and its review history, after you confirm.
- “Delete my Hanlon’s razor note in Sohki.”
Review
get_review_notes- Pick the notes that are due, or the ones you name, and quiz you one question at a time.
- “Quiz me with Sohki.”
record_review- Record each answer automatically, so the next review is scheduled for you.
- Used automatically when you answer a quiz question.
correct_reviewFree- Fix how an answer was assessed. The schedule is recalculated.
- “I actually knew that one. Correct it in Sohki.”
restart_progress- Start a note’s schedule fresh when you choose to, keeping its content, tags and history.
- “Restart my progress on la mariposa in Sohki.”
Progress
get_progressFree- See how many notes you’ve saved, what’s due, today’s reviews and your streak.
- “How is my Sohki streak going?”
get_review_history- See your past answers for all notes, one note or one tag.
- “How have my #spanish reviews gone in Sohki?”
Account
check_accountFree- Show the connected account, your plan and its limits, and where to manage billing.
- “Which Sohki plan am I on?”