Plugins

Plugins connect Soma with the tools around her. There are two kinds. Agents let an AI assistant you already work in, Claude today, talk to Soma on your behalf. Apps let Soma work with what you keep in tools such as Notion, Linear and Granola while she answers you.

Open Plugins from the button next to Attach in the message composer. Workspace admins also find Plugins under Settings, where they can switch plugins on or off for everyone.

Claude

The Soma plugin for Claude puts Soma inside Claude. Claude can ask Soma a question and carry the conversation on, brief Soma on what you shipped or decided, and hand her notes and documents to keep. Claude works with Soma the way a colleague would: it asks, and Soma does her own work in your workspace. Claude never gets Soma’s tools for pages, documents or memory.

In Claude, the plugin adds five skills: Ask Soma, Brief Soma, Design deck with Soma, Write memo with Soma and Import to Soma. Mentioning Soma in a Claude conversation is usually enough; the skills are there when you want to be explicit.

Connect Claude

1. In Claude, open the plugin directory and add Soma.
2. Select Connect on the plugin’s Connectors tab. Your browser opens Soma.
3. Sign in if you are not already, select the workspace Claude may use, and select Connect Claude. The tab returns to Claude.

Back in Soma, the Claude card in Plugins shows Active. Selecting Connect on that card first sends you to the plugin page in Claude: the connection is always completed from Claude’s side, and the card updates by itself when it is done.

One connection reaches one workspace. To let Claude use a different workspace, disconnect and connect again, choosing the other workspace.

What happens in Soma

Every conversation Claude starts appears in your chats, marked with the Claude logo, and Soma’s reply streams in live if you have the app open. You can continue any of them in the app. Claude can list and read the conversations it started here, and no others; your own conversations with Soma stay between you and her.

A brief from Claude starts a new conversation that Soma remembers, the same way she remembers what you tell her in the app. Soma knows when a message comes from Claude on your behalf rather than from you.

Each question or brief from Claude counts as a message on your seat, like a message sent in the app.

Disconnect Claude

Select Disconnect on the Claude card. Claude’s access ends at once. To use the plugin again, sign in again from Claude.

Apps

Apps let Soma work in the tools you already use, with your own access and nothing more. Soma can work with Notion, Linear, Granola, Circleback and Atlassian (Jira and Confluence) today. Apps that are not available yet, such as Slack, Gmail, Google Calendar, Microsoft 365 and Asana, show a Request button. We add apps based on demand.

Missing an app entirely? Request an app at the bottom of the list sends the app’s name and what you would use it for to the Soma team.

Connect an app

1. Select Connect on the app’s card. The app’s own sign-in opens in a new tab.
2. Approve the access the app asks for. Some apps, Circleback for example, ask separately for reading and for writing; you can allow reading only.
3. The tab confirms the connection and can be closed. The Plugins modal updates by itself.

Choose what Soma may use

A connected app lists its tools in two groups, Read-only and Write & edit. Every tool is on when you connect. Switch off any tool you do not want Soma to use; the switch reads Soma may use this tool or Soma may not use this tool.

If you allowed reading only, the write tools stay listed but cannot be switched on. The card says so: reconnect and allow writes to use them.

How Soma uses an app

Soma reaches for an app when your question concerns your own notes, tasks, meetings, mail or calendar, and she says which app she looked in. What she reads informs her reply; it is not copied into your workspace unless you ask her to keep something as a page. Before any tool that creates, changes, sends or deletes something, Soma says what she is about to do and waits for your yes.

Reconnect and disconnect

When an app’s access expires or is revoked on the app’s side, the card shows Reconnect needed. Select Reconnect and approve the access again.

Disconnect removes Soma’s access and deletes the stored credentials. The app may keep Soma in its own list of authorised applications until you remove it there.

Workspace settings

Under Settings, Plugins, a workspace admin can switch any plugin off for the whole workspace. Members then see the plugin marked Turned off by your workspace admin and cannot connect it; an existing connection stops working until the plugin is switched on again. Only workspace admins can change these settings.

Privacy

• What Claude sends to Soma is stored as an ordinary conversation in your workspace, with the same protection as everything else you tell her. See Privacy.
• Claude sees only Soma’s replies and the conversations it started. It has no access to your pages, reports, memory or other conversations.
• App credentials are encrypted and stored for you alone. Soma uses an app with your access, in your name, and only through the tools you left on.
• A request for an app sends the app’s name, your note, and who asked to the Soma team, and nothing else.