Modrinth MCP Server

by justinscott12io.github.justinscott12/modrinth-mcpv0.1.1

Search Modrinth and publish Minecraft mods via the Modrinth API: create projects, upload new versions and read project and version metadata.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained45d ago

Install Modrinth MCP server

claude mcp add modrinth -e MODRINTH_TOKEN='<modrinth-token>' -- npx -y @justinscott12/modrinth-mcp

{
  "mcpServers": {
    "modrinth": {
      "command": "npx",
      "args": [
        "-y",
        "@justinscott12/modrinth-mcp"
      ],
      "env": {
        "MODRINTH_TOKEN": "<modrinth-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "modrinth": {
      "command": "npx",
      "args": [
        "-y",
        "@justinscott12/modrinth-mcp"
      ],
      "env": {
        "MODRINTH_TOKEN": "<modrinth-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "modrinth": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@justinscott12/modrinth-mcp"
      ],
      "env": {
        "MODRINTH_TOKEN": "<modrinth-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "modrinth": {
      "command": "npx",
      "args": [
        "-y",
        "@justinscott12/modrinth-mcp"
      ],
      "env": {
        "MODRINTH_TOKEN": "<modrinth-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MODRINTH_TOKEN	—	yes	Modrinth Personal Access Token (https://modrinth.com/settings/pats). Required only for write actions; read-only tools work without it.

Freshness

Maintained — last maintenance signal 45d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-25 · 45d ago · GitHub
Latest release
2026-08-25 · 45d ago · GitHub · v0.1.2
Package published
no data · npm/PyPI
Registry entry updated
2026-08-24 · 46d ago · official registry · v0.1.1

FAQ

›How do I install the Modrinth MCP server in Claude Code?

Run: claude mcp add modrinth -e MODRINTH_TOKEN='<modrinth-token>' -- npx -y @justinscott12/modrinth-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Modrinth require an API key?

Yes. It expects MODRINTH_TOKEN, of which 1 is a secret.

›Can I use Modrinth as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Modrinth in the official MCP registry?

Yes, as io.github.justinscott12/modrinth-mcp.