Common Paper MCP server
Commit Oct 16, 2026Lets an AI assistant query, create, send, negotiate, and manage legal contracts using plain English.
Also known as CommonPaper/ai-plugin, ai-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.1
- Last commit
- Oct 16, 2026
- License
- MIT
What is Common Paper MCP?
Common Paper lets an AI assistant query, create, send, negotiate, and manage legal contracts using plain English.
Summary generated from the project's README
About Common Paper MCP server
Common Paper provides a remote MCP server that allows users to manage legal contracts through natural language. It works with various MCP clients such as Claude, Cursor, VS Code, and GitHub Copilot. Instead of managing complex API keys, the system uses OAuth for authentication, meaning you simply sign in with your existing Common Paper account to connect your assistant to your organization's agreements.
Users can perform a wide range of legal administrative tasks including searching for specific contracts, drafting new NDAs or CSAs, and tracking upcoming renewals. The server supports various agreement types like DPA, PSA, and Software Licenses. For more advanced needs, the system includes a skill that can fall back to the Common Paper REST API to handle tasks like filtering by company name or uploading Word files for custom terms.
This tool is designed for professionals who want to interact with their legal documents using plain English. It prioritizes safety by creating agreements as drafts by default and requiring manual confirmation before sending emails or changing live contract statuses.
What you can do with it
- 1Search and audit contractsAsk your assistant to find specific agreements or count how many signed documents exist.
- 2Automate agreement draftingRequest the creation of a new contract draft for a specific recipient.
- 3Monitor contract expirationsIdentify which legal agreements are set to expire in the near future.
- 4Generate template variationsCreate new templates with specific legal parameters like liability caps or invoicing terms.
- 5Onboard new accountsUse a guided process to set up a new Common Paper account and initial templates.
Written from the project's README. Every use case is checked against a quote from it.
How to install Common Paper MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Common Paper MCP in Claude Code
$ claude mcp add --transport http ai-plugin https://api.commonpaper.com/mcpInstall Common Paper MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ai-plugin": {
"url": "https://api.commonpaper.com/mcp"
}
}
}Install Common Paper MCP in VS Code
.vscode/mcp.json
{
"servers": {
"ai-plugin": {
"type": "http",
"url": "https://api.commonpaper.com/mcp"
}
}
}Install Common Paper MCP in VS Code CLI
$ code --add-mcp '{"name":"ai-plugin","type":"http","url":"https://api.commonpaper.com/mcp"}'Install Common Paper MCP in Codex
$ codex mcp add ai-plugin --url https://api.commonpaper.com/mcpInstall Common Paper MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.ai-plugin] url = "https://api.commonpaper.com/mcp"
Install Common Paper MCP in Gemini CLI
$ gemini mcp add -s user --transport http ai-plugin https://api.commonpaper.com/mcpInstall Common Paper MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ai-plugin": {
"url": "https://api.commonpaper.com/mcp",
"type": "http"
}
}
}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 reachablecommonpaper/ai-plugin is public and reachablegithub.com/commonpaper/ai-plugin ↗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-10-16github.com/commonpaper/ai-plugin ↗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 handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubCommon Paper MCP server and AI plugins
Query, create, and manage your contracts in Common Paper from your AI assistant, in plain English. Common Paper runs a remote MCP server that works with any MCP client, including GitHub Copilot, VS Code, Claude, Cursor, and ChatGPT.
This repo also packages the server as a plugin for Claude Cowork, Claude Code, Cursor, Grok Build, and Gemini CLI. The plugin bundles two things:
- The Common Paper MCP connector (
https://api.commonpaper.com/mcp). You sign in with your Common Paper account through OAuth, so there's no API key to copy or store. - A Common Paper skill that teaches how Common Paper works: agreement statuses, the Cover Page + Standard Terms model, safe defaults (every agreement starts as a draft), template parameters for each agreement type, the rules for porting contract text into custom terms without altering it, and a guided onboarding flow for new accounts.
For a few things the connector doesn't cover yet (filtering by company name or end date, uploading Word files as custom terms, and creating a brand-new account), the skill falls back to the Common Paper REST API.
What you can do
- Count and search: "How many signed NDAs do we have?" / "Do we have a contract with Acme?"
- Send agreements: "Draft an NDA to jane@example.com from ben@company.com" (the assistant creates a draft, shows you the link, and sends only when you confirm)
- Manage agreements: void, reassign the recipient, resend the signature email, download the PDF, get a shareable link
- Financial questions: "What's our largest CSA by deal value?"
- Renewals: "Which contracts expire in the next 90 days?"
- Signers: "Who signed the deal with Microsoft?"
- Templates: create and update NDA, CSA, DPA, PSA, Partnership, BAA, LOI, Software License, Design Partner, and Pilot templates
- Custom agreements: publish custom terms and build custom cover page templates
- Onboarding: "Set up my Common Paper account" walks through ten quick questions and creates a starter set of templates
Example prompts
How many signed contracts do we have, and how many are still waiting on the other side?Do we have an active NDA with Northwind? If not, draft one to sam@northwind.com from me.List every agreement that ends in the next 90 days as a table with counterparty, type, and end date.Create a CSA template with Delaware law, a 1x fees liability cap, and net-30 annual invoicing.Set up my Common Paper account.
Use with any MCP client
- Server URL:
https://api.commonpaper.com/mcp - Transport: Streamable HTTP
- Auth: OAuth. Clients that support dynamic client registration connect automatically, and you sign in with your Common Paper account. No API key needed.
VS Code and GitHub Copilot
Add this to .vscode/mcp.json:
{
"servers": {
"common-paper": {
"type": "http",
"url": "https://api.commonpaper.com/mcp"
}
}
}
Start the server from the file or the MCP servers list, then sign in to Common Paper when prompted.
OpenAI Codex CLI
codex mcp add common-paper --url https://api.commonpaper.com/mcp
codex mcp login common-paper
The first command adds the server to ~/.codex/config.toml. The second opens a browser so you can sign in to Common Paper.
Setup for other assistants (ChatGPT, Cursor, Notion, Perplexity, and more) is in Connecting Common Paper to other AI assistants.
Install as a plugin
The plugin adds a skill on top of the MCP server with Common Paper workflows and safe defaults.
Claude Cowork
Install Common Paper from the plugin directory, then connect when prompted and sign in to Common Paper.
Claude Code
Install from the plugin directory with /plugin, or add this repo as a marketplace directly:
claude plugin marketplace add CommonPaper/ai-plugin
claude plugin install commonpaper@commonpaper
Then run /mcp, choose common-paper, and sign in to Common Paper.
Cursor
Install Common Paper from the Cursor Marketplace, or add this repo to your team marketplace (Dashboard > Plugins & MCPs). Then open the Customize page, find common-paper under MCP servers, and sign in to Common Paper.
To try a local copy, clone this repo into ~/.cursor/plugins/local/commonpaper.
Grok Build
Add this repo as a marketplace and install the plugin. --trust lets Grok attach the bundled Common Paper connector.
grok plugin marketplace add CommonPaper/ai-plugin
grok plugin install commonpaper --trust
grok plugin enable commonpaper
Then sign in to Common Paper when Grok prompts you to connect common-paper.
Gemini CLI
gemini extensions install https://github.com/CommonPaper/ai-plugin
Then run /mcp auth common-paper in Gemini CLI and sign in to Common Paper.
Upgrading from the standalone skill
If you previously installed CommonPaper/claude-skill, you can remove it after installing the plugin. If the plugin ever needs an API key for the REST fallback, it copies a key saved by the old skill to ~/.config/commonpaper/cp-api-token automatically.
Requirements
- A Common Paper account
- Any MCP client with OAuth support, or for the plugin: Claude Cowork, Claude Code, Cursor, Grok Build, or Gemini CLI
- For the REST fallback only:
curland network access toapi.commonpaper.com. Custom terms and custom templates must be enabled for your organization to use those features.
Security and privacy
- The server uses OAuth. Your assistant acts as the Common Paper user who signed in and can only see that user's organization.
- With the plugin, the assistant confirms before anything that sends an email or changes a live agreement (send, void, reassign, resend, invite), and creates agreements as drafts by default.
- If the REST fallback needs an API key, the plugin mints one for the signed-in user with the connector (or asks you for one), asks whether to keep it for future sessions, stores it at
~/.config/commonpaper/cp-api-tokenwith owner-only permissions (deleting it at the end of the task if you said not to keep it), and never prints it in chat. - Contract text ported into custom terms is kept character-for-character. The assistant verifies the stored text after writing and never "fixes" typos or punctuation on its own.
- Privacy policy: https://commonpaper.com/privacy-policy/ (questions: privacy@commonpaper.com)
Troubleshooting
| Problem | Fix |
|---|---|
| The Common Paper tools aren't connected | Cowork: Customize > Connectors > Common Paper > Connect. Claude Code: run /mcp, choose common-paper, and sign in. Cursor: open the Customize page, find common-paper under MCP servers, and connect. Gemini CLI: run /mcp auth common-paper. Codex CLI: run codex mcp login common-paper. VS Code: start common-paper from .vscode/mcp.json or the MCP servers list. Other clients: connect https://api.commonpaper.com/mcp from the client's MCP settings. |
| An agreement you expect is missing | The API only covers agreements sent by your organization. Agreements you received from another organization aren't included. |
| "You've reached your plan limit" on a new account | Usually means your email address isn't verified yet. Verify it, then try again. |
| 404 on custom terms or custom templates | The feature isn't enabled for your organization. Contact Common Paper support. |
| REST fallback fails with a network error | Your environment can't reach api.commonpaper.com directly. The assistant will fall back to what the connector supports. |
| Search by company name is slow on a large account | Without the REST fallback, the assistant has to page through agreements. Allow network access to api.commonpaper.com so it can filter server-side. |
Support
- Help center: Common Paper and LLMs
- Bugs and feature requests: open an issue in this repository
- For account or connection problems, contact Common Paper support through the help center with the name of the client you're using and a screenshot of the error
Repo contents
.claude-plugin/plugin.json Plugin manifest (Claude, Grok Build)
.claude-plugin/marketplace.json Lets this repo be added as a marketplace (Claude)
.cursor-plugin/plugin.json Plugin manifest (Cursor)
.cursor-plugin/marketplace.json Lets this repo be added as a marketplace (Cursor)
.grok-plugin/marketplace.json Lets this repo be added as a marketplace (Grok Build)
.mcp.json Common Paper MCP connector (Claude, Grok Build)
mcp.json Common Paper MCP connector (Cursor)
gemini-extension.json Extension manifest and connector (Gemini CLI)
registry/server.json MCP Registry entry (com.commonpaper/contracts)
skills/commonpaper/SKILL.md Core skill
skills/commonpaper/references/ REST API, templates, custom terms, onboarding details
License
MIT
Common Paper MCP questions
How do I add Common Paper MCP to Claude Code?
Run claude mcp add --transport http ai-plugin https://api.commonpaper.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Common Paper MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I authenticate with Common Paper?
You sign in using your Common Paper account through OAuth, so there is no need to manually copy or store an API key.
Can I use this with GitHub Copilot or Cursor?
Yes, the server works with any MCP client including GitHub Copilot and Cursor.
What happens if I ask the AI to send an agreement?
The assistant will create a draft and show you the link, but it will only send the agreement once you provide confirmation.
Does the assistant change the text of my contracts?
No, contract text ported into custom terms is kept character-for-character and the assistant verifies the text without fixing typos.