Papercliped MCP server
Commit Nov 15, 2026Connects AI clients like Claude and ChatGPT to Paperclip to manage agents, issues, approvals, budgets, and reports.
Also known as OpenSourcx/papercliped
- Stars
- 13
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 15, 2026
- License
- MIT
What is Papercliped MCP?
Papercliped connects AI clients like Claude and ChatGPT to Paperclip to manage agents, issues, approvals, budgets, and reports.
Summary generated from the project's README
About Papercliped MCP server
Managing an organization of AI agents directly from your preferred chat interface is what papercliped enables. By connecting Paperclip, an open-source orchestrator, to clients like Claude, ChatGPT, or Codex, users can oversee agent activity without navigating a separate dashboard. This connection works via a remote hosted service using a public https address or through a local installation for setups without a public endpoint.
Users can choose between read-only access for viewing reports and costs or full control for active management. The system provides over 30 tools to handle tasks such as assigning issues, approving requests, and monitoring budgets. When running locally, a board token is required to interact with the Paperclip API. The setup process involves approving the connection within the Paperclip interface and selecting specific permission levels to ensure secure interaction between the AI client and the agent orchestrator.
What you can do with it
- 1Monitor agent spendingAsk your AI client to identify which agents are exceeding their allocated budgets.
- 2Assign and activate agentsDirect an AI to give a specific task to a web engineer and wake them up to start working.
- 3Generate activity summariesRequest a weekly report to see the status and activity of your agent workforce.
- 4Handle administrative approvalsUse your chat interface to authorize pending requests such as hiring.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableopensourcx/papercliped is public and reachablegithub.com/opensourcx/papercliped ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/opensourcx/papercliped ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubPapercliped
Run your Paperclip from any AI app. Papercliped connects Claude, ChatGPT, Codex and any MCP app to your Paperclip, the open-source orchestrator for companies of AI agents. Check on agents, pause or wake them, assign issues, decide approvals and get status, cost and activity reports, without opening the dashboard.
Free and open source. Website: papercliped.co · Docs: docs.papercliped.co
Papercliped is an independent community project, not made by the Paperclip team.
Add it to your AI app
You need a Paperclip with a public https address. Don't have one yet? Host your Paperclip has step-by-step guides for your own computer (free tunnel), a VPS, Railway, Render, Fly.io and Coolify. The first time you connect, you approve the request inside your own Paperclip, pick a username, save the secret key you're shown once, and choose Read only or Full control.
The connector address for every app is:
https://mcp.papercliped.co/mcp
Claude (web, desktop and mobile)
Settings → Connectors → Add custom connector, paste https://mcp.papercliped.co/mcp, then Connect.
Claude Code
Install the plugin (adds the tools, a Paperclip skill and /paperclip-status, /paperclip-sync, /paperclip-report):
/plugin marketplace add OpenSourcx/papercliped
/plugin install papercliped@papercliped
Or just the MCP server:
claude mcp add --transport http paperclip https://mcp.papercliped.co/mcp
Then run /mcp to sign in.
Codex
Install the plugin:
codex plugin marketplace add OpenSourcx/papercliped
codex plugin add papercliped@papercliped
Or just the MCP server (Codex starts the sign-in for you):
codex mcp add paperclip --url https://mcp.papercliped.co/mcp
ChatGPT
Turn on Developer mode (Settings → Apps → Advanced settings), choose Create app, paste https://mcp.papercliped.co/mcp and pick OAuth. Menu names change often; the ChatGPT guide has the current steps and the Custom GPT (Actions) option.
Any other MCP app
Add a remote MCP server (Streamable HTTP, OAuth) at https://mcp.papercliped.co/mcp. See Any AI app.
Paperclip on your own machine (no public address)
Run Papercliped locally instead. It talks straight to your Paperclip; nothing goes through papercliped.co. Use a Paperclip board token (agent keys can't pause or approve):
# Claude Code
claude mcp add paperclip --env PAPERCLIP_API_URL=http://localhost:3100 --env PAPERCLIP_API_KEY=<board token> -- npx -y papercliped@latest
# Codex
codex mcp add paperclip --env PAPERCLIP_API_URL=http://localhost:3100 --env PAPERCLIP_API_KEY=<board token> -- npx -y papercliped@latest
Add --env PAPERCLIP_READ_ONLY=1 for reports and sync only.
What you can ask
Talk to your AI app instead of clicking through the dashboard:
- "Catch me up on my Paperclip." · "Which agents are over budget?"
- "Give the Web Engineer an issue to fix the signup page, and wake them." · "Wake the CEO, wait until they finish, then summarise."
- "Approve the hire request." · "Weekly report, please."
More than 40 ready-to-copy prompts: prompt gallery.
There are 30 tools (full list). Read only can look at agents, issues, goals, costs and reports. Full control can use every tool. The AI asks before anything that can't be undone, and you can change the level or disconnect at any time.
Manage your connections in Paperclip
Install the Papercliped plugin for Paperclip (npm papercliped-paperclip-plugin, from Settings → Plugins in Paperclip). It adds a control room: see every connected app, choose which tools each may use and which agents it applies to, set API only / Full / Agent only for every agent or one at a time (or turn an agent off), read what was blocked, go anonymous, and look after your account. Plugin guide · The control room · API only, Full or Agent only.
Security and privacy
- You approve every connection inside your own Paperclip; no passwords pass through Papercliped.
- Levels are enforced by Papercliped on every call, and every call is audit-logged.
- Paperclip keys are encrypted at rest; tokens and secret keys are stored only as one-way hashes.
- Only public
httpsPaperclip addresses are reachable from the hosted service. - No trackers or third-party scripts on the website.
Threat model: docs/SECURITY.md. Report a vulnerability: SECURITY.md. Privacy: papercliped.co/privacy.
Run it yourself
The hosted service runs exactly this code. To host your own (for a team, or to keep everything on your infrastructure), see Run it yourself, docs/oauth.md and the launch guide (Render + Supabase, free tiers).
git clone https://github.com/OpenSourcx/papercliped && cd papercliped
npm install && npm test
Community and contributing
- Questions and chat: the OpenSourcedd Discord and GitHub Discussions
- Ideas, project shares and feedback: r/OpenSourcedd
- Bugs and feature requests: issues
- Contributing (setup, checks, the path from first PR to maintainer): CONTRIBUTING.md
- Code of conduct: CODE_OF_CONDUCT.md
- Every push to
mainis a release: changelog · how releases work
License
Papercliped MCP questions
Can I run it locally if my Paperclip doesn't have a public address?
Yes, you can run Papercliped locally to talk directly to your Paperclip instance using a board token.
Is there a difference between Read only and Full control?
Read only mode allows you to view agents, issues, goals, costs, and reports, while Full control enables the use of every tool.