Common Elements MCP server
Commit Nov 6, 2026Allows an AI client to research community association records, search statutes, find licensed vendors, and manage RFPs.
Also known as CommonElements/common-elements-claude-plugins, common-elements-claude-plugins
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.1.0
- Last commit
- Nov 6, 2026
- License
- MIT
What is Common Elements MCP?
Common Elements allows an AI client to research community association records, search statutes, find licensed vendors, and manage RFPs.
Summary generated from the project's README
About Common Elements MCP server
Common Elements provides an information network specifically for community associations, including HOAs, condos, and co-ops. This MCP server allows AI clients to research association records from state registries, search US community association statutes, and find licensed vendors. It is designed for users of Claude chat, Cowork, Claude Code, and Codex, though it also supports other clients like ChatGPT, Cursor, and VS Code via HTTP transport.
Users connect to the service using a Common Elements account through OAuth. The server offers different levels of data access; while basic public records are free, deeper information regarding management, officers, and building safety requires a paid Data plan. The toolset includes specific skills for running RFPs through the RFP Hub, checking licenses, and tracking changes in board or management personnel. It functions as a research companion rather than a replacement for existing management or accounting software.
What you can do with it
- 1Research association historyAn AI client can retrieve public record basics or detailed management and officer information for specific community associations.
- 2Verify legal statutesA developer can use the server to perform a full-text search of US community association statutes or run a compliance scan on provided text.
- 3Manage vendor procurementUsers can search for verified licensed contractors and manage the RFP process to review proposals.
- 4Track organizational changesThe server can monitor and report on updates to board members and management teams.
Written from the project's README. Every use case is checked against a quote from it.
How to install Common Elements MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Common Elements MCP in Claude Code
$ claude mcp add --transport http common-elements-claude-plugins https://commonelements.com/api/mcpInstall Common Elements MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"common-elements-claude-plugins": {
"url": "https://commonelements.com/api/mcp"
}
}
}Install Common Elements MCP in VS Code
.vscode/mcp.json
{
"servers": {
"common-elements-claude-plugins": {
"type": "http",
"url": "https://commonelements.com/api/mcp"
}
}
}Install Common Elements MCP in VS Code CLI
$ code --add-mcp '{"name":"common-elements-claude-plugins","type":"http","url":"https://commonelements.com/api/mcp"}'Install Common Elements MCP in Codex
$ codex mcp add common-elements-claude-plugins --url https://commonelements.com/api/mcpInstall Common Elements MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.common-elements-claude-plugins] url = "https://commonelements.com/api/mcp"
Install Common Elements MCP in Gemini CLI
$ gemini mcp add -s user --transport http common-elements-claude-plugins https://commonelements.com/api/mcpInstall Common Elements MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"common-elements-claude-plugins": {
"url": "https://commonelements.com/api/mcp",
"type": "http"
}
}
}Configuration
CLAUDE_CONFIG_DIR
| Name | Description | |
|---|---|---|
| CLAUDE_CONFIG_DIR | — |
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 reachablecommonelements/common-elements-claude-plugins is public and reachablegithub.com/commonelements/common-elements-claude-plugins ↗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-06github.com/commonelements/common-elements-claude-plugins ↗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 Elements plugins for Claude
A plugin marketplace for Claude chat, Cowork and Claude Code from Common Elements, the information network for community associations.
| Plugin | What it adds |
|---|---|
common-elements |
The hosted Common Elements MCP server plus skills to research an association, find vendors, run an RFP, check a statute and track board and management changes |
Install
For Claude chat and Cowork, add this marketplace under Customize > Plugins, install Common Elements, then connect it from the plugin’s Connectors tab. Installation is specific to your current Claude organization.
For Claude Code, in your shell:
claude plugin marketplace add CommonElements/common-elements-claude-plugins
claude plugin install common-elements@common-elements
Or inside Claude Code:
/plugin marketplace add CommonElements/common-elements-claude-plugins
/plugin install common-elements@common-elements
Then run /mcp, choose plugin:common-elements:common-elements and sign in with your Common Elements account (OAuth). To receive new versions automatically, open /plugin, then Marketplaces, then common-elements, and turn on auto-update. Otherwise run claude plugin update common-elements@common-elements.
Prefer the server without the skills? claude mcp add --transport http common-elements https://commonelements.com/api/mcp. Every other client (Claude on the web and desktop, ChatGPT, Cursor, VS Code, Codex) is covered at https://commonelements.com/developers/mcp.
Codex reads the same repository: codex plugin marketplace add CommonElements/common-elements-claude-plugins.
What it does, honestly
- Association records: HOA, condo and co-op associations from state registries and other public records. Free access returns public-record basics; deeper sections (management, officers, change feed, building safety, hazard risk) need a paid Data plan. Coverage varies by state and county, and every response says where its data came from.
- Statutes: full-text search and section text for US community association statutes, plus a read-only compliance scan of text explicitly supplied for that purpose. Reference information, not legal advice.
- Vendors and RFPs: contractors and other licensed firms from state licensing-board records, license checks, and the RFP Hub for posting work and reviewing proposals (drafts are private; publishing needs your confirmation). The searchable list of verified Common Elements vendor profiles is small and growing; it only includes vendors that have completed verification.
- Common Elements complements the management and accounting software associations already use. It is not management or accounting software.
Data and privacy
Personal contact details (email, phone, mailing address) for individuals, such as board members, officers and licensees, are never returned by the MCP server. Board and officer data is names and titles from public records. The service stores requested account content and retains usage and action logs while your account is open. The plugin README describes transmission, retention and revocation. Privacy policy: https://commonelements.com/privacy. Questions: hello@commonelements.com.
Releasing (maintainers)
- Change the plugin under
plugins/common-elements/. Skills must use tool names that exist on the live server (apps/web/app/api/[transport]/_lib/in the Common Elements app); rename a tool there and update the skills in the same release. - Bump
versioninplugins/common-elements/.claude-plugin/plugin.json(and the Codexplugin.jsonbeside it). The version lives only in the plugin manifests, never inmarketplace.json. Users stay on the old copy until it changes. claude plugin validate .andclaude plugin validate --strict plugins/common-elementsmust pass. CI runs both.- Install from your local checkout in an isolated config and confirm the skills and the MCP server load:
export CLAUDE_CONFIG_DIR=$(mktemp -d) claude plugin marketplace add ./ claude plugin install common-elements@common-elements claude plugin details common-elements@common-elements - Run
claude plugin eval plugins/common-elements --no-publishand review the with/without results. The bundled disconnected scenarios verify safe fallback behavior; they do not replace live-tool testing through MCP Inspector and Claude, or testing on each supported surface. - Open a PR and merge it after the required evidence passes. Optionally run
claude plugin tag --pushfrom the plugin directory.
Never rename a published plugin. If a rename is unavoidable, add the old name to renames in marketplace.json ({"old-name": "new-name"}). The map is append-only: never remove an entry, or users of the old name lose the plugin.
License
MIT for the files in this repository. Common Elements itself is covered by its terms.
Common Elements MCP questions
How do I add Common Elements MCP to Claude Code?
Run claude mcp add --transport http common-elements-claude-plugins https://commonelements.com/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Common Elements MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does the server provide legal advice?
No, the statute search provides reference information only and is not intended as legal advice.
Are personal contact details shared?
Personal contact details like email, phone, or mailing addresses for individuals are never returned by the MCP server.
How can I find and verify vendors?
You can search for licensed contractors from state licensing-board records and access a list of verified Common Elements vendor profiles.