Yalp MCP Server

Local MCP server that lets Cursor/Claude create and manage Yalp todos.

Install (Cursor)

Create a Yalp API key in the app, then install the MCP server in Cursor using the config below.

MCP Config

{
  "mcpServers": {
    "yalp": {
      "command": "npx",
      "args": ["-y", "-p", "yalp-mcp-server", "yalp-mcp"],
      "env": {
        "YALP_API_KEY": "yalp_<your_key_here>",
        "YALP_API_BASE_URL": "https://www.yalp.work"
      }
    }
  }
}

Environment variables

• YALP_API_KEY (required): Yalp API key generated from the app.
• YALP_API_BASE_URL (optional): Yalp base URL (defaults to https://www.yalp.work). Override for preview deployments or local tunnels.

Note: Claude.ai (web) uses the hosted remote MCP URL https://www.yalp.work/api/mcp/stream with headers — not this npm stdio package. This package calls the legacy JSON endpoint /api/mcp with your API key in the request body.

Versioning and npm

The MCP server’s reported version matches package.json (single source of truth). Before publishing: bump version in package.json, run pnpm build, then npm publish from apps/mcp-server.

Tools

Friendly aliases (recommended):

• /todo list
• /todo create
• /todo update
• /todo delete
• /list list
• /list create
• /list resolve

Legacy names (still supported):

• list_lists
• create_list
• resolve_list
• list_todos
• create_todo
• update_todo
• delete_todo