drio
Open app

supabase-nextjs-server MCP Server

Source

Catalog onlyCatalog onlySTDIO

Overview

Supabase NextJS MCP Server is a TypeScript-based Model Context Protocol (MCP) server that implements a simple notes system for NextJS, demonstrating core MCP concepts.

To use the server, set up the required environment variables, install dependencies, and configure it with Claude Desktop. You can create and summarize notes using the provided tools and prompts.

  • Requires NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY for initialization. - Allows listing and accessing notes via note:// URIs. - Provides tools for creating new text notes and generating summaries of stored notes.
  1. Creating and managing text notes in a NextJS application.
  2. Summarizing notes for quick reference.
  3. Integrating with Claude Desktop for enhanced note-taking capabilities.

Add to your AI client

Use these steps to connect supabase-nextjs-server MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "supabase-nextjs-mcp-server-tengfone": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-nextjs-mcp-server-tengfone"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "supabase-nextjs-mcp-server-tengfone": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-nextjs-mcp-server-tengfone"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "supabase-nextjs-mcp-server-tengfone": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-nextjs-mcp-server-tengfone"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "supabase-nextjs-mcp-server-tengfone": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-nextjs-mcp-server-tengfone"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "supabase-nextjs-mcp-server-tengfone": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-nextjs-mcp-server-tengfone"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "supabase-nextjs-mcp-server-tengfone": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-supabase-nextjs-mcp-server-tengfone"
      ]
    }
  }
}

FAQ

What are the requirements to run the server?

You need to set the `NEXT_PUBLIC_SUPABASE_URL` and `NEXT_PUBLIC_SUPABASE_ANON_KEY` environment variables.

How do I create a new note?

Use the `create_note` tool with the required title and content parameters.

Can I debug the server?

Yes, you can use the MCP Inspector for debugging, which provides a URL to access debugging tools in your browser.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1125,"uuid":"d3701fec-f1a1-48c3-9093-918d654fc28a","name":"supabase-nextjs-mcp-server","title":"supabase-nextjs-server MCP Server","description":null,"avatar_url":"https://avatars.githubusercontent.com/u/20770447?v=4","created_at":"$D2025-01-28T02:33:10.939Z","updated_at":"$D2025-02-23T07:20:09.253Z","status":"created","author_name":"tengfone","author_avatar_url":"https://avatars.githubusercontent.com/u/20770447?v=4","tags":"supabase,nextjs,mcp-server","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/tengfone/supabase-nextjs-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/02249516813836e3a48777df7c3dd325a9bcafc6b243e27bff643e9ab3a6acda/68747470733a2f2f736d6974686572792e61692f62616467652f4074656e67666f6e652f73757061626173652d6e6578746a732d6d63702d736572766572","type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools