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

> Easily install a community plugin for Claude with our complete setup guide. Upload your plugin bundle and configure environment variables in just a few steps.

- Repository: [Anthropic/claude-plugins-community](https://github.com/anthropics/claude-plugins-community)
- Tags: how-to-guide
- Published: 2026-08-27

---

**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`](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/plugin.json)** — The core manifest defining the plugin name, description, entry points, and required permissions
- **[`.claude-plugin/marketplace.json`](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/marketplace.json)** — Optional metadata for icons, categories, and marketplace display
- **[`README.md`](https://github.com/anthropics/claude-plugins-community/blob/main/README.md)** — Human-readable documentation covering installation steps and runtime configuration
- **[`SKILL.md`](https://github.com/anthropics/claude-plugins-community/blob/main/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`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/.claude-plugin/plugin.json), while the Tres Finance plugin uses [`tres-finance-plugin/.claude-plugin/plugin.json`](https://github.com/anthropics/claude-plugins-community/blob/main/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`](https://github.com/anthropics/claude-plugins-community/blob/main/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`](https://github.com/anthropics/claude-plugins-community/blob/main/plugin.json) manifest and registers the plugin

The validation process verifies that [`.claude-plugin/plugin.json`](https://github.com/anthropics/claude-plugins-community/blob/main/.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`](https://github.com/anthropics/claude-plugins-community/blob/main/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`](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/plugin.json) | Defines entry points, permissions, and plugin metadata |
| [`README.md`](https://github.com/anthropics/claude-plugins-community/blob/main/README.md) | Contains setup instructions and configuration requirements |
| [`skills/.../SKILL.md`](https://github.com/anthropics/claude-plugins-community/blob/main/skills/.../SKILL.md) | Describes available skills with input schemas |

Claude rejects any plugin bundle missing the [`plugin.json`](https://github.com/anthropics/claude-plugins-community/blob/main/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:

```bash
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`](https://github.com/anthropics/claude-plugins-community/blob/main/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`](https://github.com/anthropics/claude-plugins-community/blob/main/quickdesign/README.md).

Once active, invoke the plugin directly in conversation:

```text
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`](https://github.com/anthropics/claude-plugins-community/blob/main/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`](https://github.com/anthropics/claude-plugins-community/blob/main/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`](https://github.com/anthropics/claude-plugins-community/blob/main/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`](https://github.com/anthropics/claude-plugins-community/blob/main/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`](https://github.com/anthropics/claude-plugins-community/blob/main/.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.