magnet

This Magnet MCP Server provides a bridge to the Magnet platform via the MCP interface. It uses the official Magnet MCP server package, invoked through npx, to connect your workspace’s API key to the MCP transport so you can interact with Magnet features through your MCP-enabled clients. Once configured, clients such as Cursor/ Claude Desktop or Claude Code can communicate with Magnet through the MCP layer and leverage Magnet’s capabilities in prompts and workflows.

To use it, configure the Magnet section in your MCP settings (as shown in the README) with the npx invocation for the magnet-mcp-server and your API key. Clients can then connect to this MCP server using the standard MCP transport named Magnet. If you encounter issues, verify that your Node.js/npx version matches the guidance and consider specifying a full path to your npx executable in the command field.

Prerequisites:

• macOS (as noted in the repository) with sudo access
• Node.js installed (recommended LTS, e.g., 18.x or newer) and npm or npx available
• A Magnet API key generated for your Workspace/Organization

Installation steps:

1. Install Node.js and npm from https://nodejs.org/ (or use your preferred Node version manager).
2. Ensure npx is available by running: node -v and npm -v; then npx -v should return a version.
3. Obtain your Magnet API key from https://www.magnet.run/settings or the Desktop app Settings → MCP.
4. Configure the MCP server using the example from the README (Cursor/Claude Desktop) or Claude Code commands provided in the README to start using the magnet-mcp-server package via npx.
5. If you need to customize paths or versions, consider using a full path to npx in the command field as suggested in the notes.

Tips:

• If MCP configuration fails, it might be due to Node.js/npx version mismatches. Consider specifying the full path to your npx executable in the command field.
• The server expects your MAGNET_API_KEY to be set; never commit real keys in public repos. Use a secure method to inject environment variables.
• This MCP server is macOS-focused per the README; cross-platform support is planned, so expect potential platform-specific caveats.
• If using Claude Code, the exact command to add the MCP transport is provided in the README and should be adapted to your environment if needed.