Obris Claude Plugin

Install Obris in Claude. The same plugin works in Claude Code (the terminal CLI) and in Cowork (the desktop app).

The plugin's goal is to sync your Obris knowledge to disk through the obris CLI, where Claude can read your topics as files. That's faster than calling a server every time, and it leaves Claude more room to focus on what you actually asked. The bundled MCP server keeps your knowledge reachable when Claude doesn't have filesystem access.

What you get

• MCP server: List topics, read items, and save knowledge from any Claude Code or Cowork session.
• /obris:sync: Sync a topic to a local directory. Pulls remote items down, pushes local edits back, bulk-uploads via --add-all, manages exclude/include rules per directory.
• /obris:add: Push a single local file into a synced topic.
• /obris:link: Relink a renamed file to its remote item.
• /obris:unlink: Stop syncing a file without deleting either side.
• /obris:auth: Set up Obris CLI authentication.

Install the plugin

Pick the install path that matches where you run Claude. The same plugin works in both surfaces; you only install it once per surface.

In Claude Code (the terminal CLI)

In a running Claude Code session:

/plugin marketplace add obris-dev/obris-claude-plugin
/plugin install obris@obris

Then open the plugin manager and activate it:

/plugin

Reload to pick up the skills and MCP server:

/reload-plugins

In Cowork

Cowork doesn't ship a discoverable marketplace, so you add the Obris marketplace by hand the first time:

1. Open Customize in Cowork.
2. Click the + next to Personal Plugins and choose Add Marketplace.
3. Paste obris-dev/obris-claude-plugin (a GitHub owner/repo, or the full git URL) and click Sync.
4. Open Browse Plugins → Personal, click obris-claude-plugin, and hit + to install.

Enable the MCP server (one-time auth)

The plugin registers Obris's MCP server with Claude, but you still have to authorize it once before tool calls work. The flow differs between Claude Code and Cowork.

In Claude Code

After installing the plugin and running /reload-plugins, open the MCP manager:

/mcp

Pick obris from the list and follow the sign-in prompt. Authorize Obris in your browser, then return to the session. Every future Obris tool call uses your account.

In Cowork

Open Settings → Connectors. Find the Obris custom connector and click Connect. Authorize Obris in your browser, then return to Cowork.

Authorization is per device. A second Claude Code workstation, or Cowork on another machine, walks through the same step.

CLI authentication

The sync, add, and link skills shell out to the bundled obris CLI. The first time the agent runs an obris command, the /obris:auth skill walks you through a two-step browser sign-in. No API keys to copy.

The MCP server works without ever invoking the CLI. The CLI is only involved for the disk-level sync commands.

Check the connection

Once installed and signed in, verify the plugin is wired up by asking Claude:

List my Obris topics

You should see the topics in your Obris account. If a topic is empty or new, you can also try:

What knowledge do I have in my [topic name] topic?

Troubleshooting

Using something other than Claude? See the Obris Codex plugin, or connect Obris directly via the CLI, the MCP server, or an MCP connector.