YouMind MCP Server

MCP stdio server for YouMind OpenAPI. It can be used by any agent or MCP client that supports launching local stdio MCP servers.

Setup

cd youmind-mcp-server
npm install
npm test

Environment

• YOUMIND_API_KEY: required YouMind API key.
• YOUMIND_BASE_URL: optional API base URL. Defaults to https://youmind.com/openapi/v1.

MCP Client Configuration

Different agents use different config file formats, but they all need the same launch information:

• Command: node
• Arguments: ["/absolute/path/to/youmind-mcp-server/index.js"]
• Environment: YOUMIND_API_KEY=your-api-key
• Optional environment: YOUMIND_BASE_URL=https://youmind.com/openapi/v1

If your client supports a working directory (cwd), you can also use:

• Command: node
• Arguments: ["index.js"]
• Working directory: /absolute/path/to/youmind-mcp-server

Generic JSON-style clients

Use this shape for agents that configure MCP servers with JSON:

{
  "mcpServers": {
    "youmind": {
      "command": "node",
      "args": ["/absolute/path/to/youmind-mcp-server/index.js"],
      "env": {
        "YOUMIND_API_KEY": "your-api-key"
      }
    }
  }
}

TOML-style clients

Use this shape for agents that configure MCP servers with TOML:

[mcp_servers.youmind]
command = "node"
args = ["/absolute/path/to/youmind-mcp-server/index.js"]
env = { YOUMIND_API_KEY = "your-api-key" }

Some clients support cwd; in that case this shorter form is also valid:

[mcp_servers.youmind]
command = "node"
args = ["index.js"]
cwd = "/absolute/path/to/youmind-mcp-server"

[mcp_servers.youmind.env]
YOUMIND_API_KEY = "your-api-key"

Restart or reload your agent after editing its MCP configuration.

Tools

• youmind_search: semantic search across the library or a board.
• youmind_list_boards: list boards with optional filters.
• youmind_get_default_board: get the default board.
• youmind_get_craft: read a craft by id.
• youmind_list_files: aggregate listCrafts and listMaterials for a board.
• youmind_create_document_by_markdown: create a document from Markdown.
• youmind_call: call a documented YouMind OpenAPI endpoint by name.

youmind_call blocks endpoints beginning with trash, delete, or ungroup to prevent accidental destructive operations.