markstrom/portal-mcp

Turn any website or customer portal into MCP tools, without an open API and without writing code. portal-mcp is a Claude Code plugin and a local MCP server. You point it at a site, log in yourself if the site needs it, and the plugin explores the pages in a real browser, learns how they load their data, and lets you choose which tools Claude gets: list your invoices, download a PDF, look something up, fill in a form.
Works with logged-in services, customer portals and public sites.
You log in yourself, in a visible browser window. The runtime never reads or stores your password.
Each service is described by a YAML manifest. The runtime turns the manifest into MCP tools.
Sessions are stored encrypted. The encryption key lives in your system keyring.
Write actions run in two steps and only after you approve them yourself, in a dialog or a local confirmation page. The model cannot approve its own actions.
Every write action is logged in a local audit log.
Status: version 0.9.7. Runtime with read, file, write and binding tools and human approval; logins through other hosts, BankID and OpenID Connect apps; data hosts called with the app's own token; HTML pages as read tools; file uploads; public sites without login; encrypted sessions and several profiles per service; a recorder that explores pages by itself and captures writes without sending them; selftest, desktop notifications, the portal-mcp-creator skill and the slash commands. Tested against a local mock service.
## Requirements
A computer with a graphical desktop: macOS, Windows, or Linux with a desktop environment.
uv to run the runtime.
Google Chrome (preferred), or Playwright's Chromium: uv run playwright install chromium.
## Install
Pick the way that matches where you use Claude. Everything except the last option installs the whole plugin: the runtime, the portal-mcp-creator skill and the /portal-mcp: commands.
| Where you use Claude | Way to install |
| Claude Code in a terminal | Slash commands or the command line |
| The Claude desktop app, Code tab | The command line or the app's plugin settings |
| Claude Code in VS Code or JetBrains | The command line |
| A team or a project | Project settings |
| Working on the plugin itself | A local clone |
| Another MCP client, or the desktop app's chat | The runtime alone (tools only) |
While the repository is private, every way fetches it with your local git credentials, so only accounts with access can install it. With the GitHub CLI: gh auth login, then gh auth setup-git.
### Claude Code in a terminal
text
/plugin marketplace add markstrom/portal-mcp
/plugin install portal-mcp@portal-mcp
/plugin opens an interactive dialog, so it works only in Claude Code in a terminal.
### The command line
Run these in any terminal. Claude Code in a terminal, the desktop app and the IDE extensions share the same installation, so this works for all of them:
bash
claude plugin marketplace add markstrom/portal-mcp
claude plugin install portal-mcp@portal-mcp
Restart the app or Claude Code afterwards so the plugin is loaded.
### The Claude desktop app, Code tab
The Code tab cannot run /plugin. Either use the command line and restart the app, or add the marketplace markstrom/portal-mcp in the app's plugin settings and install portal-mcp from there.