Niffler MCP Server

MCP server for Niffler — manage bookmarks, notes, and tasks from Claude, Cursor, and other AI assistants.

Quick Setup

1. Get your API key

Sign in to Niffler, go to Settings > API Keys, and create a new key.

2. Add to your AI tool

Claude Desktop — Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "niffler": {
      "command": "npx",
      "args": ["-y", "niffler-mcp"],
      "env": {
        "NIFFLER_API_KEY": "nif_your_key_here"
      }
    }
  }
}

Claude Code (CLI):

claude mcp add niffler -- npx -y niffler-mcp

Then set your API key:

export NIFFLER_API_KEY="nif_your_key_here"

Cursor — Add to .cursor/mcp.json:

{
  "mcpServers": {
    "niffler": {
      "command": "npx",
      "args": ["-y", "niffler-mcp"],
      "env": {
        "NIFFLER_API_KEY": "nif_your_key_here"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | niffler_list_categories | List all categories | | niffler_update_category | Update category settings | | niffler_list_items | List items with filters | | niffler_create_bookmark | Create a bookmark | | niffler_create_note | Create a markdown note | | niffler_create_task | Create a task with optional due date | | niffler_complete_task | Toggle task completion | | niffler_get_dividers | Get sections in a category | | niffler_create_divider | Create a new section | | niffler_delete_item | Delete any item | | niffler_update_item | Update item properties | | niffler_search | Full-text search across all items | | niffler_health_check | Verify API connection |

Requirements

• Node.js 18+
• A Niffler account with API key access