# Use Specset from Claude

> Install the Specset plugin in Claude or Claude Code to search specs, drawings, submittals, and RFIs with agent skills and native MCP tools.

Source: https://docs.specset.com/docs/claude-plugin · Section: Agents · Last updated: 2026-10-19

The Specset plugin teaches Claude to work with your Specset organization: search specs and drawings, set up projects, manage submittals, RFIs, and closeout data, chat with project agents, and move files between your computer and Specset. It bundles `/specset` skills plus a native MCP connector, all powered by the `specset` CLI, and works in the Claude app and in Claude Code.

## Install in the Claude app

1. Open **Settings → Plugins** and click **Browse** to open the plugin directory.
2. On the **Personal** tab, click **+**, then choose **Add from a repository**.
3. Enter `specsetai/specset-plugins`, pick the matching repository, and click **Sync**. Leave **Sync automatically** on so plugin updates flow in when a new version is published.

![Add marketplace dialog with the specsetai/specset-plugins repository entered and automatic sync enabled](https://docs.specset.com/images/docs/claude-plugin/add-marketplace.png)

4. The marketplace appears as **specset-plugins**. On the **Specset** plugin card, click **+** to install — that's it.

Open the card to see everything the plugin registers — the skills and the `specset` MCP connector:

![Specset plugin details showing skills and the specset MCP connector](https://docs.specset.com/images/docs/claude-plugin/plugin-details.png)

## Install in Claude Code

The same plugin installs from the terminal:

```
/plugin marketplace add specsetai/specset-plugins
/plugin install specset
```

## First run: sign in

The skills are self-bootstrapping. The first time you ask a Specset question, Claude installs the `specset` CLI (Node.js 22+ required) and walks you through sign-in. With a visible local browser it uses `specset login`; in a remote or headless session it falls back to device authentication:

```bash
specset login --device
```

The CLI prints a code and link you can approve from any device. Credentials stay with the CLI via browser OAuth — the agent never sees or stores them, and the skills default to read-only operations, asking before anything that changes data.

Then just ask a question:

> *"What mechanical equipment is scheduled on level 2 of my project?"*

## Upload and download files

Because the Claude plugin runs locally, it can use file paths on your computer. Ask Claude to attach a submittal, RFI response, project document, image, or other supported file and it will stream the file through the CLI:

```bash
specset files upload ./submittal.pdf --json
```

The command returns the cloud file ID needed by the related Specset workflow. Downloads use the matching project or record download command, so large files do not need to be copied into the conversation first.

Using Codex too? The [Specset plugin for Codex](https://docs.specset.com/docs/chatgpt-codex) includes the same skills, MCP tools, authentication flow, and local file support.