Integrations & MCP

Claude Code

Give Claude Code full access to your Poly files with the polymcp plugin.

The Poly plugin gives Claude Code the poly-cli agent skill plus the MCP connection it needs to search, read, create, update, and organize your Poly files — from personal drives and shared drives alike.

Install

claude plugin marketplace add withpoly/polymcp
claude plugin install poly@poly

That's it. The plugin comes from the polymcp repo and updates through the plugin marketplace.

For the best experience, also install the Poly desktop app and its CLI: with the local poly binary available, Claude Code works against your local cache — fast, offline-capable, and able to reference files in your sync folder by local path. Without it, the plugin uses Poly's hosted MCP server (https://mcp.poly.app/mcp) and signs you in with OAuth on first use.

What Claude Code can do with it

> find the API design doc I was editing last week and summarize the open questions

> take every screenshot in //Home/inbox, tag it blue:triage, and move it to //Home/screenshots

> what changed in //Home/legal/lease.pdf since yesterday? restore it if the edits look accidental

Under the hood the skill composes poly commands — search, ls, file read, file update, mv, and friends — the same commands you can run yourself.

Safety

The integration runs the CLI with force disabled (--disallow-force), so the agent can archive files but can never permanently delete anything. Everything it removes lands in your Archive and is recoverable — see Recovering Files.

See Using MCP for the tool reference and troubleshooting tips.

Overview

Connect Poly to AI assistants, code editors, and other tools using the Model Context Protocol.

Claude CoWork (Desktop)

Install the Poly extension in Claude's desktop app straight from the Poly app.