For AI agents: a documentation index is available at /llms.txt. A markdown version of this page is available at the same URL with .md appended (or via Accept: text/markdown).
Skip to main content

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​

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​

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​

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​

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​

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​

On this page