tampermonkey-mcp — Claude Code MCP server: features and setup
This MCP server lets an AI assistant inspect and edit Tampermonkey userscripts. It’s useful when you want to manage browser scripts through your coding assistant.
claude mcp add tampermonkey-mcp -- npx -y tampermonkey-mcpWhat tampermonkey-mcp does
The server exposes tools to list userscripts, read one, and apply changes. It connects to Tampermonkey through the Tampermonkey Editors browser extension. Ask the assistant for a connection code, then enter that code in the extension to enable the script tools.
Install the Tampermonkey and Tampermonkey Editors extensions first; Editors is available for Firefox or Chrome. In Claude Code, add the server with claude mcp add tampermonkey-mcp -- npx -y tampermonkey-mcp. The connection code step matters: without entering it in Tampermonkey Editors, the assistant cannot reach your scripts.
What it helps with
- list Tampermonkey userscripts
- read a selected userscript
- edit a browser userscript through an assistant
- connect Tampermonkey Editors to an MCP server
Example prompts for the agent
- List my Tampermonkey scripts.
- Read the userscript that changes this site’s layout.
- Edit my userscript to hide the selected page element.
How to install tampermonkey-mcp
Platform CLI
claude mcp add tampermonkey-mcp -- npx -y tampermonkey-mcpPlatform CLI
codex mcp add tampermonkey-mcp -- npx -y tampermonkey-mcpConfig file
{
"mcpServers": {
"tampermonkey-mcp": {
"command": "npx",
"args": [
"-y",
"tampermonkey-mcp"
]
}
}
}Config file
{
"servers": {
"tampermonkey-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tampermonkey-mcp"
]
}
}
}Platform CLI
gemini mcp add tampermonkey-mcp npx -y tampermonkey-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about tampermonkey-mcp
How do I install tampermonkey-mcp in Claude Code?
Run claude mcp add tampermonkey-mcp -- npx -y tampermonkey-mcp. Install Tampermonkey and Tampermonkey Editors, ask the assistant for a connection code, then enter it in Tampermonkey Editors.
What does tampermonkey-mcp do?
It connects an AI assistant to Tampermonkey Editors and provides tools to list, read, and modify userscripts.
Which browser extensions does tampermonkey-mcp need?
Install Tampermonkey and Tampermonkey Editors. The Editors extension is available for Firefox or Chrome and receives the connection code from the assistant.
