How to Install a Community Plugin for Claude: A Complete Setup Guide

Installing a community plugin for Claude requires uploading a .claude-plugin bundle through Claude’s Plugins settings, then configuring any required environment variables.

Claude community plugins extend Claude’s capabilities through self-contained bundles hosted in the anthropics/claude-plugins-community repository. Each plugin follows a standardized structure that Claude validates automatically during installation.

Understanding the Plugin Bundle Structure

Community plugins are self-contained directories that include a .claude-plugin subdirectory with required manifest files. Before installing, verify that your plugin folder contains the core validation files:

• .claude-plugin/plugin.json — The core manifest defining the plugin name, description, entry points, and required permissions
• .claude-plugin/marketplace.json — Optional metadata for icons, categories, and marketplace display
• README.md — Human-readable documentation covering installation steps and runtime configuration
• SKILL.md — Technical specifications for individual Claude skills, including input schemas and example usage

For example, the QuickDesign plugin stores its manifest at quickdesign/.claude-plugin/plugin.json, while the Tres Finance plugin uses tres-finance-plugin/.claude-plugin/plugin.json.

Step-by-Step Installation Process

Follow these three steps to install a community plugin for Claude.

Choose a Community Plugin

Browse the anthropics/claude-plugins-community repository to locate plugin folders such as quickdesign, testdino, or tres-finance-plugin. Each folder contains a README.md that explains the plugin’s purpose, required API keys, and specific configuration steps.

Upload the Plugin to Claude

Open Claude’s Plugins settings and complete the registration:

1. Click Add a plugin → Upload a plugin
2. Drag-and-drop the entire plugin folder (the parent directory containing the .claude-plugin subfolder) or select it via the file picker
3. Claude automatically validates the plugin.json manifest and registers the plugin

The validation process verifies that .claude-plugin/plugin.json exists and contains valid JSON schema definitions before completing registration.

Configure Environment Variables and API Keys

Some plugins require external API keys or environment variables. After the plugin appears in Claude’s list:

1. Click Configure on the plugin entry
2. Fill in required values as described in the plugin’s README.md
3. Save the configuration to activate the plugin’s skills

Required Files for Plugin Validation

During upload, Claude validates the following files according to the source code structure:

File	Purpose
.claude-plugin/plugin.json	Defines entry points, permissions, and plugin metadata
README.md	Contains setup instructions and configuration requirements
skills/.../SKILL.md	Describes available skills with input schemas

Claude rejects any plugin bundle missing the plugin.json manifest, ensuring all community plugins meet the technical specifications defined in the repository.

Example: Installing the QuickDesign Plugin

The QuickDesign plugin demonstrates the typical installation workflow for Claude community plugins.

First, clone or download the plugin folder:

git clone https://github.com/anthropics/claude-plugins-community.git
cd claude-plugins-community/quickdesign

Next, in Claude navigate to Settings → Plugins → Add a plugin and select the quickdesign folder. Claude reads quickdesign/.claude-plugin/plugin.json and registers the plugin immediately.

If QuickDesign requires an API key for external design services, open the plugin’s entry in Claude’s plugin list, click Configure, and paste the key as instructed in quickdesign/README.md.

Once active, invoke the plugin directly in conversation:

User: Design a modern logo for a coffee shop.
Claude (QuickDesign): *[generates logo concepts]*

Summary

Installing a community plugin for Claude involves uploading a validated .claude-plugin bundle through Claude’s interface. Key takeaways include:

• Community plugins reside in self-contained folders with a .claude-plugin subdirectory
• Claude validates plugin.json manifests before registration
• Configuration of API keys occurs after upload via the Configure button
• The anthropics/claude-plugins-community repository contains reference implementations like QuickDesign and TestDino

Frequently Asked Questions

Where do I find community plugins for Claude?

Community plugins are available in the anthropics/claude-plugins-community GitHub repository. Each plugin lives in its own folder (such as quickdesign or tres-finance-plugin) and includes documentation in README.md files.

What file format does Claude require for plugin installation?

Claude requires a directory containing a .claude-plugin subfolder with a valid plugin.json manifest file. You upload the parent folder (not a compressed archive) through Claude’s Upload a plugin interface.

Can I install multiple community plugins at once?

You must install community plugins individually through Claude’s Plugins settings. Each plugin requires separate validation of its plugin.json manifest and individual configuration of API keys or environment variables.

Why does Claude reject my plugin upload?

Claude rejects uploads missing the required .claude-plugin/plugin.json file or containing invalid JSON schema. Ensure your plugin folder includes the core manifest file and follows the directory structure defined in the anthropics/claude-plugins-community source code.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}