forme.gifts MCP server

Your wishlist,in any AI host.

Create lists, add gifts, and curate everything from inside Claude Code, Claude Desktop, Cursor, or any MCP-compatible client. One npm package, one sign-in, every host.

What it does

Justtalk to it.

The forme.gifts MCP server plugs your wishlists into your AI assistant. Once it's installed, you stop clicking through menus. You describe what you want in plain English and the assistant does it for you.

"Add a Hario V60 to my kitchen wishlist."
Adds a gift with a name and link.
"What’s on my Christmas list right now?"
Reads a wishlist back to you.
"Take that ceramic vase off — I already bought one."
Removes a gift after a confirmation.
"Start a new wishlist called ‘Reading list’."
Creates a fresh wishlist.

Install

Pick yourhost.

Claude Code

Run this in any terminal. The --scope user flag installs it once for every project.

Terminal

claude mcp add --scope user formegifts -- npx -y @formegifts/mcp

Claude Desktop, Cursor & Gemini CLI

Same JSON, three places: Claude Desktop's claude_desktop_config.json (Settings → Developer → Edit Config), Cursor's Settings → MCP, and Gemini CLI's ~/.gemini/settings.json. Merge the snippet into the host's config and reload.

JSON

{
  "mcpServers": {
    "formegifts": {
      "command": "npx",
      "args": ["-y", "@formegifts/mcp"]
    }
  }
}

Codex CLI

Append this block to ~/.codex/config.toml. Codex CLI uses TOML, not JSON.

TOML

[mcp_servers.formegifts]
command = "npx"
args = ["-y", "@formegifts/mcp"]

Any other MCP host

If your host accepts arbitrary MCP commands, point it at the package directly. The first run downloads it via npx.

Terminal

npx -y @formegifts/mcp

Authentication

Sign inonce.

Two ways to sign in. Both go through the same browser confirmation and store credentials in your home directory (~/.config/forme/credentials.json on macOS and Linux, %APPDATA%\forme on Windows), scoped to the current OS user.

From your AI host

Just ask the host to sign you in. It calls auth_start, opens a browser confirmation, and finishes via auth_poll. No CLI required.

"Sign me in to forme.gifts." That's it.

From a terminal

Sign in once from a shell — handy for CI, Codespaces, or pre-warming credentials before installing the server in your host.

Terminal

npx @formegifts/mcp auth

Source on GitHub. Package on npm.

@formegifts/mcp GitHub