Subtext Docs

Appearance

Connect Claude ​

You need a Subtext account that has finished onboarding, and the Google account you signed up with. Connecting never creates a Subtext account; if you don't have one yet, sign up in the app first.

Claude.ai, Desktop and mobile ​

Connectors you add on claude.ai are available in Claude Desktop and the Claude mobile apps as well, so you only need to do this once.

From the Connectors directory ​

Once Subtext is listed in Claude's directory:

  1. Open Claude's directory and search for Subtext.
  2. Choose Connect.
  3. When Claude asks you to sign in, choose Google and use the same Google account you use for Subtext.

That's all. There is nothing to paste and no key to manage.

As a custom connector ​

If Subtext isn't listed yet, or you prefer to add it yourself:

  1. Open Customize → Connectors in Claude.

  2. Choose +, then Add custom connector.

  3. Give it the name Subtext and paste this URL:

    https://mcp.subtext.wiki/mcp

  4. Save, then choose Connect. Claude opens a sign-in window; sign in with the Google account you use for Subtext.

On some Claude plans, custom connectors can only be added by an organisation owner. If you don't see the option, ask whoever manages your Claude organisation.

Turn it on in a conversation ​

Connectors can be switched on and off per conversation from the tools menu in the message box. Make sure Subtext is on when you want Claude to use your context.

Install the skill in claude.ai ​

The connector lets Claude read your context. The Subtext skill is what teaches it to use that context well: brief itself first, look before asking, and write durable facts back. Clients that load skills from the connection can pick it up automatically, but installing it by hand makes sure it's there.

  1. Download the skill as a zip:

    https://api.subtext.wiki/skills/subtext.zip

  2. Open Customize → Skills in Claude and choose Add.

  3. Upload the zip you downloaded. Upload the file as it is; don't unzip it first.

Claude's skill uploader accepts only a zip whose top level is the skill folder, which is why this link is a zip rather than a plain file.

Claude Code ​

Sign in with OAuth ​

Run this in a terminal:

bash
claude mcp add --transport http "Subtext" https://mcp.subtext.wiki/mcp

Then start Claude Code, run /mcp, choose Subtext and follow the sign-in prompt. Use the same Google account you use for Subtext.

Or use an access key ​

If you'd rather not sign in through a browser, or you want a connection with a narrower scope, create an access key on the Connections page (see Other clients for how), then run:

bash
claude mcp add --transport http "Subtext" https://mcp.subtext.wiki/mcp --header "Authorization: Bearer <key>"

Replace <key> with the key you copied. The key is shown only once when you create it.

Install the skill for Claude Code ​

Claude Code reads skills from ~/.claude/skills. This puts the Subtext skill there:

bash
mkdir -p ~/.claude/skills/subtext && curl -s https://api.subtext.wiki/skills/subtext.md -o ~/.claude/skills/subtext/SKILL.md

Start a new Claude Code session afterwards so it picks the skill up.

What to expect on first use ​

Ask Claude something about your work, for example "What should I focus on this week?"

  • Claude calls the brief tool once, near the start of the conversation. You'll see the tool call in the conversation. It doesn't repeat the brief back to you; it uses it as background.
  • When a question touches a particular person or project, Claude searches or reads that part of your graph before answering.
  • When a reply used your Subtext context, it ends with exactly one line naming what it drew on, such as "Subtext supplied context about the Harbour project and Priya." If nothing from Subtext went into a reply, there's no line.
  • If you tell Claude something durable, such as "We've decided to launch in March", it records it in Subtext and tells you what it recorded.

If the first tool call fails, see Troubleshooting.