The Supabase NextJS MCP Server is a TypeScript-based server that implements a simple notes system while providing tools for Supabase database interaction.
Manage Notes: Create, list, and access text notes via
note://URIs with metadataSummarize Notes: Generate summaries of stored notes using structured prompts
Supabase Operations: Perform complete CRUD operations—query, insert, update, and delete records with optional column selection and filters
Development Tools: Includes build commands and debugging support through MCP Inspector
Installation: Can be installed manually or via Smithery for Claude Desktop integration
Provides tools for database operations in Supabase including querying data, inserting records, updating records, and deleting records, allowing interaction with Supabase tables from a NextJS application.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Supabase NextJS MCP Servercreate a note titled 'Meeting Notes' with the content 'Discussed project timeline and deliverables'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
supabase-nextjs-server MCP Server
A Model Context Protocol server
This is a TypeScript-based MCP server that implements a simple notes system for NextJS. It demonstrates core MCP concepts by providing:
Resources representing text notes with URIs and metadata
Tools for creating new notes
Prompts for generating summaries of notes
Features
Init
Require
NEXT_PUBLIC_SUPABASE_URLandNEXT_PUBLIC_SUPABASE_ANON_KEYenvironment variables
Resources
List and access notes via
note://URIsEach note has a title, content and metadata
Plain text mime type for simple content access
Tools
create_note- Create new text notesTakes title and content as required parameters
Stores note in server state
Prompts
summarize_notes- Generate a summary of all stored notesIncludes all note contents as embedded resources
Returns structured prompt for LLM summarization
Related MCP server: drupal-modules-mcp MCP Server
Development
Install dependencies:
npm installBuild the server:
npm run buildFor development with auto-rebuild:
npm run watchInstallation
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"supabase-nextjs-server": {
"command": "/path/to/supabase-nextjs-server/build/index.js"
}
}
}Installing via Smithery
To install Supabase Notes for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @tengfone/supabase-nextjs-mcp-server --client claudeDebugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspectorThe Inspector will provide a URL to access debugging tools in your browser.
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.