Plugins

Plugins package rules, skills, agents, commands, MCP servers, and hooks into distributable bundles. Browse official plugins in the Cursor Marketplace. For community plugins and MCP servers, browse cursor.directory. You can also build your own to share with other developers.

What plugins contain

A plugin can bundle any combination of these components:

The marketplace

The Cursor Marketplace is where you discover and install official plugins. Plugins are distributed as Git repositories and submitted through the Cursor team. Every plugin is manually reviewed before it's listed. Browse official plugins at cursor.com/marketplace or search by keyword in the marketplace panel. For community plugins and MCP servers, browse cursor.directory.

Required vs optional plugins

When you assign a plugin to a distribution group, you can set it as required or optional:

• Required: After you click Save, the plugin is installed automatically for everyone in that distribution group.
• Optional: The plugin is available to everyone in that distribution group, and each developer can choose whether to install it.

How do distribution groups work with SCIM?

Distribution groups can be controlled with SCIM-synced directory groups. If your organization uses SCIM, manage group membership in your identity provider, and Cursor will sync those group updates.

Add a team marketplace

Use this flow to import a GitHub repository as a team marketplace:

1. Go to Dashboard -> Settings -> Plugins.
2. In Team Marketplaces, click Import.
3. Paste the GitHub repository URL and continue.
4. Review the parsed plugins. Optionally set Team Access groups, then continue.
5. Set the marketplace name and description, then save.

Example repository to try:

• fieldsphere/cursor-team-marketplace-template

Where developers find team marketplaces

Developers can find team marketplaces in the marketplace panel in Cursor.

• Open the marketplace panel in Cursor.
• Look for plugins from your team marketplace.
• Install optional plugins directly from that panel.
• Required plugins are installed automatically when admins save the required setting for your distribution group.

Installing plugins

Install plugins from the marketplace. Plugins can be scoped to a project or installed at the user level.

Managing installed plugins

MCP servers

Toggle MCP servers on or off from Cursor Settings:

1. Open Settings ( Cmd+Shift+JCtrl+Shift+J)
2. Go to Features > Model Context Protocol
3. Click the toggle next to any server

Disabled servers won't load or appear in chat.

Rules and skills

Manage rules and skills from the Rules section of Cursor Settings. Toggle individual rules between Always, Agent Decides, and Manual modes. Skills appear in the Agent Decides section and can be invoked manually with /skill-name in chat.

Creating plugins

A plugin is a directory with a .cursor-plugin/plugin.json manifest and your components (rules, skills, agents, commands, hooks, or MCP servers). Start from the plugin template repository or create one from scratch:

my-plugin/
├── .cursor-plugin/
│   └── plugin.json
├── rules/
│   └── coding-standards.mdc
├── skills/
│   └── code-reviewer/
│       └── SKILL.md
└── mcp.json

The manifest only requires a name field. Components are discovered automatically from their default directories, or you can specify custom paths in the manifest.

{
  "name": "my-plugin",
  "description": "Custom development tools",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

Test plugins locally

Before you publish, load your plugin from ~/.cursor/plugins/local:

1. Create a folder for your plugin: ~/.cursor/plugins/local/my-plugin
2. Copy your plugin files into that folder. Make sure .cursor-plugin/plugin.json is at the plugin root.
3. Restart Cursor, or run Developer: Reload Window.
4. Verify your plugin components load in Cursor, such as rules, skills, or MCP servers.

For faster iteration, symlink your plugin repository:

ln -s /path/to/my-plugin ~/.cursor/plugins/local/my-plugin

When your plugin is ready, submit it for review at cursor.com/marketplace/publish. For multi-plugin repositories, add a marketplace manifest at .cursor-plugin/marketplace.json.

FAQ

Are marketplace plugins reviewed for security?

Yes. Every plugin is manually reviewed before it's listed. All plugins must be open source, and we review each update before publishing. See Marketplace security for details on vetting, update reviews, and how to report issues.

How do I create a plugin?

Create a directory with a .cursor-plugin/plugin.json manifest file, add your rules, skills, agents, commands, or other components, and submit it to the Cursor team. See the Plugins reference for the full guide.