# Shape

This MCP server for Claude Code connects an agent to a Shape file workspace. It can search, read and save files after OAuth sign-in.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: shapefs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/shapefs/shape-plugin
- Updated: 2026-11-11
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/shape

## What it does

Shape gives an AI agent access to a shared file workspace. It can search folders and files, inspect images, read text and earlier versions, and download originals. With editing access, it can create folders, save or revise text, upload files, move and rename items, apply tags, and restore versions.

A Shape account and workspace are needed. Sign-in happens in a browser through OAuth, where the workspace and permitted actions are selected. Changes require an active workspace plan, and access follows the user’s membership and approved capabilities. Agents cannot permanently delete files, manage members, or change billing. Text extracted from PDFs may be incomplete; moving an item to Trash does not permanently remove it.

## Requirements
- Remote server: `https://shapefs.app/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http shape https://shapefs.app/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add shape --url https://shapefs.app/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "shape": {
            "url": "https://shapefs.app/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "shape": {
            "type": "http",
            "url": "https://shapefs.app/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http shape https://shapefs.app/mcp
```

## When to use it
- locate assets in a Shape workspace
- read a file or inspect its versions
- save an agent’s draft to a shared folder
- rename, move, or tag workspace files
- restore an item from Trash

## Example prompts
- Find the brand rules in Shape and summarize them.
- Save this brief to the Shape folder I linked.
- Rename the draft in Shape and tag it for the campaign.

## Similar
- [om-ux-shape](https://affpapa.org/en/nevibecode/skills/om-ux-shape.md) — skill · 3300 installs
- [dx-org-shape-manage](https://affpapa.org/en/nevibecode/skills/dx-org-shape-manage.md) — skill · 1200 installs
- [shape-your-agent](https://affpapa.org/en/nevibecode/skills/shape-your-agent.md) — skill · 1200 installs
- [shape-image](https://affpapa.org/en/nevibecode/prompts/shape-image.md) — prompt · ★ 12746 repo stars
- [api-shape-explorer](https://affpapa.org/en/nevibecode/skills/api-shape-explorer.md) — skill · ★ 4719 repo stars
- [module-shape](https://affpapa.org/en/nevibecode/rules/module-shape.md) — rule · ★ 2966 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
