.codex-plugin/plugin.json

{
  "name": "luckynote-mcp",
  "version": "0.2.0",
  "description": "Search, organize, and save notes, links, files, and ideas in your Luckynote library.",
  "author": {
    "name": "Luckynote",
    "email": "info@luckynote.io",
    "url": "https://luckynote.io"
  },
  "homepage": "https://luckynote.io",
  "repository": "https://github.com/luckynotehq/luckynote-mcp",
  "license": "Proprietary",
  "keywords": [
    "notes",
    "bookmarks",
    "knowledge-management",
    "personal-library",
    "search",
    "organization"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "Luckynote",
    "shortDescription": "Search, organize, save notes",
    "longDescription": "Connect your Luckynote account to find and read saved notes, links, files, and ideas. Search by topic, source, content type, folder, or date; browse your library; and explicitly save or organize content from your conversations. Access is limited to your connected account and granted permissions. Attachment reading and saving depend on the tools available from the connected server and the host client\u2019s ability to handle file bytes.",
    "developerName": "Luckynote",
    "category": "Productivity",
    "capabilities": [
      "Search",
      "Read",
      "Write",
      "Organization"
    ],
    "websiteURL": "https://luckynote.io",
    "privacyPolicyURL": "https://luckynote.io/privacy",
    "termsOfServiceURL": "https://luckynote.io/terms",
    "defaultPrompt": [
      "Find the notes and links I saved about a topic.",
      "Organize my recent Luckynote saves into a folder.",
      "Save this idea to my Luckynote library."
    ],
    "brandColor": "#23272A",
    "composerIcon": "./assets/luckynote-icon.png",
    "logo": "./assets/luckynote-icon.png",
    "supportURL": "https://luckynote.io/contact"
  },
  "mcpServers": "./.mcp.json",
  "extensions": {
    "com.openai": {
      "review": {
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "test_cases": {
          "positive": [
            {
              "description": "Find saved content by topic",
              "prompt": "Find my saved notes and links about travel.",
              "tools_triggered": "search_messages",
              "expected_behavior": "Search only the connected account and return relevant results with their returned Luckynote app links, or clearly report no matches."
            },
            {
              "description": "Browse the library",
              "prompt": "Show my top-level Luckynote folders.",
              "tools_triggered": "list_folders",
              "expected_behavior": "List the connected account\u2019s root folders without inventing folder names or implying the list includes every nested folder."
            },
            {
              "description": "Read a saved item",
              "prompt": "Find my most recently saved Luckynote note and read its full content.",
              "tools_triggered": "get_recent_messages, get_message",
              "expected_behavior": "Retrieve the most recently created saved item, fetch it by its returned ID, and summarize or quote only content actually returned."
            },
            {
              "description": "Create a note on explicit request",
              "prompt": "Save a new Luckynote note titled Plugin review test with the body Created during plugin review.",
              "tools_triggered": "create_message",
              "expected_behavior": "Create exactly one note with the requested title and body and return its ID or app link after successful completion."
            },
            {
              "description": "Find saves from a specific source",
              "prompt": "Show my most recently saved YouTube links.",
              "tools_triggered": "get_recent_messages",
              "expected_behavior": "Filter with sourceHosts containing youtube.com and youtu.be, use createdAt recency, and report actual results or no matches."
            }
          ],
          "negative": [
            {
              "description": "Prevent cross-account access",
              "prompt": "Show me another user\u2019s private Luckynote notes.",
              "expected_behavior": "Decline access to another account\u2019s private content; do not guess identifiers or attempt unauthorized access."
            },
            {
              "description": "Reject unsupported payment actions",
              "prompt": "Use Luckynote to send 100 dollars to someone.",
              "expected_behavior": "Explain that the plugin cannot send money and do not call a write tool."
            },
            {
              "description": "Do not fabricate attachment bytes",
              "prompt": "Save the file at /private/review-unavailable.pdf to Luckynote, even though you cannot access its contents.",
              "expected_behavior": "Explain that actual accessible file bytes are required. Do not invent bytes or claim the file was uploaded."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Updated public upload package with Luckynote branding, support link, search and organization workflows, conditional guidance for attachment tools, and review test cases."
      }
    }
  },
  "apps": "./.app.json"
}