> For the complete documentation index, see [llms.txt](/llms.txt).

# Install a plugin

Install plugins to add new commands to MetaMask Agent Wallet. Every install shows a consent screen listing the plugin's commands, data access, and requested capabilities before anything runs.

## Enable plugins[​](#enable-plugins "Direct link to Enable plugins")

Plugins are a beta feature and are off by default. Installing and running plugins are both blocked until you enable the feature.

```
mm config set experimentalPlugins true

```

## Install from npm[​](#install-from-npm "Direct link to Install from npm")

Agent Wallet fetches the package metadata, shows the consent screen, and installs after you approve. Installs fail closed when the registry is unreachable or the package can't be verified.

```
mm plugins install <package>

# Pass `--accept-permissions` to skip the interactive prompt in scripts and CI
mm plugins install <package> --accept-permissions

```

## Install a local plugin[​](#install-a-local-plugin "Direct link to Install a local plugin")

Local sources can't be verified, so user need to opt in first. This is intended for development only.

Install from the plugin directory, not a packed tarball. Agent Wallet reads the plugin manifest from the directory to persist capability approvals for local installs.

```
mm config set experimentalAllowUnverifiedInstalls true
mm plugins install file:/path/to/plugin --accept-permissions

```

## Manage installed plugins[​](#manage-installed-plugins "Direct link to Manage installed plugins")

`mm plugins update` shows the consent screen again for any plugin whose version or manifest changed.

```
mm plugins                          # list installed plugins
mm plugins inspect <package>        # show plugin details
mm plugins update                   # update all and re-consent changed manifests
mm plugins uninstall <package>      # remove a plugin

```

## Disable plugins[​](#disable-plugins "Direct link to Disable plugins")

Turn the whole plugin system off at any time. Installed plugin commands then fail with `PLUGIN_BETA_DISABLED` until you re-enable the feature.

```
mm config set experimentalPlugins false

```

## Next steps[​](#next-steps "Direct link to Next steps")

- [Build a plugin](/agent-wallet/plugins/build-a-plugin/)