Shape — Claude Code MCP server: features and setup
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.
MIT updated 2026-11-11
claude mcp add --transport http shape https://shapefs.app/mcpWhat Shape 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.
What it helps with
- 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 for the agent
- 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.
How to install Shape
Platform CLI: remote server
claude mcp add --transport http shape https://shapefs.app/mcpPlatform CLI: remote server
codex mcp add shape --url https://shapefs.app/mcpConfig file
{
"mcpServers": {
"shape": {
"url": "https://shapefs.app/mcp"
}
}
}Config file
{
"servers": {
"shape": {
"type": "http",
"url": "https://shapefs.app/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http shape https://shapefs.app/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Shape
How do I install Shape in Claude Code?
Add the MCP server with claude mcp add --transport http shape https://shapefs.app/mcp, then finish signing in through OAuth.
What does Shape do?
It lets an agent search and read files in a Shape workspace, inspect versions, and make file changes allowed by the granted capabilities.
What does Shape need to work?
A Shape account and workspace are required, along with OAuth sign-in. An active workspace plan is required for changes; access also depends on membership and approved capabilities.