Plugins

Plugins package rules, skills, agents, commands, MCP servers, and hooks into distributable bundles.

Cursor supports the Agent Plugins open standard alongside its own plugin format. Install and manage them from the Customize page or 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 Agent Plugins standard

Plugins bundle reusable components an agent can use. Agent Plugins is the open standard for packaging portable skills and MCP servers, much like Agent Skills defines a standard for individual skills. Cursor supports Agent Plugins alongside Cursor Plugins.

• Agent Plugins: spec-conformant plugins with a plugin.json manifest at the plugin root, packaging skills and MCP servers
• Cursor Plugins: plugins with a .cursor-plugin/plugin.json manifest, which add rules, agents, commands, hooks, and variables

A plugin that follows the Agent Plugins specification loads in Cursor. Cursor does not expand the standard's ${PLUGIN_ROOT} and ${PLUGIN_DATA} variables in mcp.json; use ${CURSOR_PLUGIN_ROOT} for the plugin root. See MCP servers in the reference. Cursor Plugins continue to develop in parallel with the standard, so Cursor-specific components and marketplace features keep working as they do today.

Learn more at agent-plugins.org or read the specification on GitHub.

Cursor Plugin canvases

Plugins now ship with prebuilt canvases: shared setup templates your team can open and reuse.

• Hex Canvas — Build data visualizations. At Cursor, we use the Hex Canvas to explore and share analytics.
• Atlassian Canvas — See a realtime view of your issues, projects, and documents from Jira and Confluence.

Open a canvas from an installed plugin in Customize to get a guided starting point instead of configuring everything from scratch.

The marketplace

The Cursor Marketplace is where you discover and install official Cursor 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 Customize. For community plugins and MCP servers, browse cursor.directory.

Team marketplaces

Team marketplaces are available on Teams and Enterprise plans. They can distribute Agent Plugins and Cursor Plugins through the same marketplace.

• Teams plan: up to 1 team marketplace
• Enterprise plan: unlimited team marketplaces

On the Teams plan, the Default marketplace doesn't count toward the imported marketplace limit, so a team can also import one team marketplace.

Contact sales for unlimited team marketplaces and Enterprise admin controls.

Open Dashboard -> Plugins & MCPs to manage Team Marketplaces.

Default team marketplace

The Default team marketplace connects shared plugins and MCP servers across Cursor. Admins can add Team MCP servers that are already available to Cloud Agents, then make the same servers available for teammates to install and configure in the Agent Window, IDE, and CLI.

The Default marketplace can't be renamed or deleted. If a legacy Default marketplace has a different name, it still keeps the Default role.

Adding a Team MCP server to the Default marketplace does not install or enable it for every developer. Admins still control marketplace access and plugin installation modes. Each developer may also need to authenticate with the MCP provider.

Migrate existing Team MCPs

Admins can link standalone Team MCP servers to the Default marketplace:

1. Open Dashboard -> Plugins & MCPs.
2. Find Team MCP Servers.
3. Select Add to Team Marketplace in the migration prompt.
4. Review the Default marketplace, its access, and plugin installation modes on the same page.

Cursor creates the Default marketplace if needed and links the existing MCP servers to it. The servers remain available to Cloud Agents while teammates gain the option to install and configure them locally.

Marketplace access

Team marketplaces are available to everyone in their team by default. Under Marketplace Settings -> Marketplace Access, admins can restrict a marketplace to selected Organization Groups. Only members of the marketplace's team who belong to a selected group receive access. Team admins retain access.

How does SCIM work?

Organization Groups can sync membership from your identity provider through SCIM. Manage membership in your identity provider, and Cursor syncs those updates to the Organization Group.

Existing marketplaces that use team-level SCIM directory groups keep that configuration. Cursor does not migrate those assignments automatically. Organizations without Organization Groups continue to use SCIM directory groups.

Plugin installation modes

After setting marketplace access, choose how each plugin is distributed to that audience:

• Default Off: Developers can find the plugin and choose whether to install it.
• Default On: The plugin is installed by default, but developers can opt out.
• Required: The plugin is always installed and cannot be uninstalled.

Add a plugin from its Marketplace page

Team admins can add a plugin to a team marketplace from the plugin's page in the Cursor Marketplace:

1. Open the plugin's page and click Add to Cursor.
2. Select Add to Team.
3. Under Available Marketplaces, select the team marketplaces to add it to.
4. Under Access Settings, set Plugin Installation to Default Off, Default On, or Required.
5. Click Add Plugin.

Add to Team appears only when your team has at least one team marketplace. Members who aren't team admins can add the plugin for themselves only.

Allow members to publish

On the Default marketplace, admins control whether members can publish personal skills:

1. Open Dashboard → Plugins & MCPs.
2. Open the Default team marketplace, then Marketplace Settings.
3. Turn Allow Members to Publish on or off.

The setting is on by default. When it is off, only team admins can publish new skills. Skills members already published stay available, and those authors can still update or unpublish them.

See Publish a skill to your team.

Serve marketplace from Cursor

On a GitHub-imported team marketplace, admins can turn on Serve marketplace from Cursor under Marketplace Settings. Cursor keeps a synced copy of this repository and serves plugins from it, so team members can use the marketplace without GitHub access to the source repo. Access is controlled by Marketplace access.

While the first sync is in progress, the setting shows Syncing and stays locked. If repo sync cannot complete, access continues being served from GitHub.

This setting applies to GitHub-imported marketplaces. Imports from GitLab, Bitbucket, or Azure DevOps keep serving from the source repository.

Add a team marketplace

Use this flow to import a repository as a team marketplace. Import from Repo accepts GitHub, GitLab, Bitbucket, and Azure DevOps URLs. Connect that provider if Cursor asks.

1. Go to Dashboard -> Plugins & MCPs.
2. In Team Marketplaces, click Add Marketplace.
3. Follow the instructions to create a marketplace from scratch, or use Import from Repo and paste the repository URL.
4. Add and review plugins using "Add to Marketplace".
5. Under Marketplace Settings, set Marketplace Access, optionally enable Auto Refresh, then save.

Example repository to try:

• fieldsphere/cursor-team-marketplace-template

Keep plugins up to date

Plugins are indexed when you first import the repository. You can refresh them in two ways:

• Automatically: On GitHub imports, turn on Enable Auto Refresh to update plugins whenever changes are pushed to the branch the marketplace tracks. This requires the Cursor GitHub App installed on the repository. Cursor re-indexes a marketplace at most once every 10 minutes, batching rapid pushes to the latest commit.
• Manually: Click Refresh to update from the repository.

A running Cloud Agent, including each agent in a Project, keeps the plugin versions it started with. Start a new agent to pick up an update.

Where developers find team marketplaces

Developers can find team marketplaces in Customize.

• Open Customize in the sidebar
• Look for plugins from your team marketplace.
• Install Default Off plugins directly from that panel.
• Default On plugins are installed automatically, but developers can opt out.
• Required plugins are installed automatically and cannot be uninstalled.
• Install and configure marketplace MCP servers for use in the Agent Window, IDE, and CLI.

Publish a skill to your team

On Teams and Enterprise plans, members can publish a personal skill from ~/.cursor/skills/ to the team's Default marketplace.

1. Open Customize and go to Skills.
2. Open the personal skill you want to share.
3. Choose Publish and confirm.

Cursor packs the skill into a plugin, stores a copy in a repository hosted for your team, and adds it to the Default marketplace. The skill then loads from that plugin instead of your local folder.

After you publish:

• Installs are opt-in. Teammates find the skill in the team marketplace and install it themselves. Publishing does not install it for anyone else. The author gets it automatically.
• Authors stay in control. Publishing moves the skill out of ~/.cursor/skills/ into the plugin's install folder on your machine. To update it, open the skill from Customize → Skills, edit it there, then choose Sync changes from the skill's menu or Sync from the Published menu on the open SKILL.md. Unpublish returns the skill to your machine.
• One skill, one plugin. The plugin is named after the skill. Publishing does not bundle other skills the published skill references.

Access follows your existing marketplace access settings. Admins can turn member publishing off with Allow Members to Publish.

To use personal skills with your own Cloud Agents without sharing them, sync them instead.

Installing plugins

Install Agent Plugins and Cursor Plugins from a marketplace. Cursor detects the format from the plugin manifest, so the installation flow is the same for both:

1. Open Customize in the sidebar.
2. Find the plugin you want to use.
3. Select Install and choose a project or user scope.

An Agent Plugin has a plugin.json manifest at its root. A Cursor Plugin has a .cursor-plugin/plugin.json manifest. Team marketplaces can distribute either format using the same access and installation modes described above.

You can also develop either format from ~/.cursor/plugins/local. See Test plugins locally for the folder layout and when Cursor loads it.

MCP Apps deeplinks

Share MCP server configurations using install links:

cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_ENCODED_CONFIG

See MCP install links for details on generating these links.

Managing installed plugins

Open Customize in the sidebar to manage installed Agent Plugins, Cursor Plugins, MCP servers, rules, and skills from one page. Filter by user, workspace, or team scope to see what is installed.

MCP servers

Toggle personal and team-distributed MCP servers on or off from Customize:

1. Open Customize in the sidebar
2. Find the MCP server you want to change
3. Use the toggle to enable or disable it

Disabled servers won't load or appear in chat.

Rules and skills

Manage rules and skills from Customize. 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.

Using the workspaceOpen hook

A workspaceOpen hook can return plugin paths to load on workspace open, which is useful when the set of plugins depends on the workspace itself.

Creating plugins

A plugin is a directory with a manifest and its components. Choose Agent Plugins when you want to package portable skills and MCP servers. Choose Cursor Plugins when you also need Cursor-specific components such as rules, agents, commands, hooks, or variables.

my-plugin/├── plugin.json├── skills/│   └── code-reviewer/│       └── SKILL.md└── mcp.json

{  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",  "name": "my-plugin",  "description": "Portable code review tools",  "version": "1.0.0",  "author": { "name": "Your Name" }}

Start from the Cursor Plugin template repository, or read the Agent Plugins authoring guide to create an Agent Plugin.

Test plugins locally

Before you publish, put either plugin format in ~/.cursor/plugins/local:

1. Create a folder for your plugin: ~/.cursor/plugins/local/my-plugin
2. Copy your plugin files into that folder. Include either a root plugin.json for an Agent Plugin or .cursor-plugin/plugin.json for a Cursor Plugin.
3. Restart Cursor, or run Developer: Reload Window.
4. Open Customize and confirm the plugin components you expect, such as rules, skills, or MCP servers.

After a reload, Cursor discovers plugins in this folder if local plugin imports are allowed.

Symlinks in ~/.cursor/plugins/local load only when the target resolves to a directory inside that folder. Cursor skips a symlink that points to a plugin repository elsewhere on disk.

When your plugin is ready, submit it for review at cursor.com/marketplace/publish. Cursor Plugins can use .cursor-plugin/marketplace.json for multi-plugin repositories.

See the Plugins reference for the full manifest schema, component formats, and submission checklist.

FAQ

Related

• Plugins help
• Skills