Connect Paper to Gemini CLI
AI-native design canvas built on HTML and CSS. Its MCP server lets agents read artboards, export JSX and write new designs straight onto the canvas.
MCP serverOfficialChecked 2026-11-16
Before you start
- Gemini CLI installed (see its MCP documentation (opens in a new tab)).
- Paper is available on macOS, Windows, Linux and the web.
- Install the Paper CLI;
~/.paper/bin/paper mcpstarts a stdio relay to the open Paper file. Use the full path: on some Linux systemspaperon PATH is libpaper's paper-size tool. Observed working on Linux.
Step 1: Add Paper to Gemini CLI
Add it from the terminal
Run this in your project folder. It saves the server to the project's
.gemini/settings.json.Terminal gemini mcp add paper ~/.paper/bin/paper mcpOr edit the config file
Add this to
.gemini/settings.jsonin your project, or to~/.gemini/settings.jsonto use it in every project..gemini/settings.json { "mcpServers": { "paper": { "command": "/path/to/home/.paper/bin/paper", "args": [ "mcp" ] } } }Good to know- In the config file, replace
/path/to/homewith your home folder's full path, for example/Users/youor/home/you.
- In the config file, replace
Step 2: Check it's connected
Terminal gemini mcp listIn a Gemini CLI session, run
/mcpto see each server, its status and its tools.Step 3: Try a first request
Ask Gemini CLI something that only works with Paper connected:
Say to Gemini CLI Look at the selected artboard in Paper and describe its layout, colours and type styles.
If it doesn't work
- Since June 2026, Gemini CLI works with a paid Gemini API key or an enterprise licence. If you signed in with a personal Google account, use Google Antigravity instead.
gemini mcp addsaves to the project's.gemini/settings.jsonby default. Add--scope userto save it to~/.gemini/settings.jsonfor every project.- Local servers only show as connected in folders you trust. Run
gemini trustin the project folder. - Gemini CLI hides environment variables that look like secrets from servers unless the server's
envblock lists them.






