drio
Open app

convex-mcp-server MCP Server

Source

Catalog onlyCatalog onlySTDIO

Overview

The convex-mcp-server is a TypeScript-based server that demonstrates core MCP (Model Context Protocol) concepts through a simple notes system.

To use the convex-mcp-server, install the dependencies, build the server, and configure it with the Claude Desktop application. You can create new text notes via specified commands.

  • Handles notes with note:// URIs and associated metadata. - Provides tools to create new text notes with a title and content. - Supports plain text mime type for easy access to note content.
  1. Managing simple text notes for quick access and storage.
  2. Creating and debugging custom MCP servers for developers working with the model context protocol.
  3. Integrating with applications like Claude Desktop for enhanced note-taking capabilities.

Add to your AI client

Use these steps to connect convex-mcp-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": {
    "convex-mcp-server-handfuloflight": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-convex-mcp-server-handfuloflight"
      ]
    }
  }
}

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": {
    "convex-mcp-server-handfuloflight": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-convex-mcp-server-handfuloflight"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

{
  "mcpServers": {
    "convex-mcp-server-handfuloflight": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-convex-mcp-server-handfuloflight"
      ]
    }
  }
}

VS Code (Copilot)

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

.vscode/mcp.json

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "convex-mcp-server-handfuloflight": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-convex-mcp-server-handfuloflight"
      ]
    }
  }
}

Cline

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

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "convex-mcp-server-handfuloflight": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-convex-mcp-server-handfuloflight"
      ]
    }
  }
}

FAQ

How do I install the server?

Install the dependencies with `npm install`, and then build the server with `npm run build`.

Can I use it with other platforms?

Currently, it's designed to work specifically with Claude Desktop through its configuration.

What is the MCP Inspector?

The MCP Inspector is a debugging tool that helps you monitor the communication of MCP servers, accessible via a browser URL provided by the tool.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":319,"uuid":"7aeff706-3f41-4be2-9dba-70ca6dc31d76","name":"convex-mcp-server","title":"convex-mcp-server MCP Server","description":null,"avatar_url":"https://avatars.githubusercontent.com/u/149564126?v=4","created_at":"2024-12-13T13:19:12.656Z","updated_at":"2024-12-13T15:09:09.488Z","status":"created","author_name":"handfuloflight","author_avatar_url":"https://avatars.githubusercontent.com/u/149564126?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/handfuloflight/convex-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"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