{"_id":"@aikaisi/margo-mcp","_rev":"6-2656d419a93b39b27278725596817445","name":"@aikaisi/margo-mcp","dist-tags":{"latest":"0.1.6"},"versions":{"0.1.0":{"name":"@aikaisi/margo-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","margo","code-notes","annotations","ai","claude","claude-code","cursor","continue","copilot"],"author":{"name":"Abbas Al-Kaisi","email":"alkaisiabbas@gmail.com"},"license":"AGPL-3.0-only","_id":"@aikaisi/margo-mcp@0.1.0","maintainers":[{"name":"aikaisi","email":"alkaisiabbas@gmail.com"}],"homepage":"https://github.com/aikaisi/margo-mcp#readme","bugs":{"url":"https://github.com/aikaisi/margo-mcp/issues"},"bin":{"margo-mcp":"dist/index.js"},"dist":{"shasum":"1fad9e3d6b28f50e1b5b939cdf0821e2e58656bf","tarball":"https://registry.npmjs.org/@aikaisi/margo-mcp/-/margo-mcp-0.1.0.tgz","fileCount":15,"integrity":"sha512-xVavIU0pkkmGqXstFPuL0yRLgnxXKSWvs1a+7QandJf/IJ9TLoJDYFk6sYDweED7z4AtsX1BSeBBu2R9sJdTNw==","signatures":[{"sig":"MEQCIEWjoWCyGc7o6yJxgXxXz+M8Jkva4cXpySmubqTl9ib9AiAUtDoUTnERQ9gpdLojA1kDybbxFZ+n+uXioPVnJsQJpA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":89496},"main":"./dist/index.js","engines":{"node":">=18"},"gitHead":"5e85fc3dc39752617521a6f3dadbf299fb953981","scripts":{"build":"tsc -p .","clean":"rm -rf dist","start":"node dist/index.js","watch":"tsc -p . --watch","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"aikaisi","email":"alkaisiabbas@gmail.com"},"repository":{"url":"git+https://github.com/aikaisi/margo-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for the Margo VS Code extension — exposes list/add/update/resolve tools so any MCP-compatible AI tool (Claude Code, Cursor, Continue, etc.) can read and write Margo code notes.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.23.0","zod-to-json-schema":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.x"},"_npmOperationalInternal":{"tmp":"tmp/margo-mcp_0.1.0_1776807809992_0.579909744391605","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@aikaisi/margo-mcp","version":"0.1.2","keywords":["mcp","model-context-protocol","margo","code-notes","annotations","ai","claude","claude-code","cursor","continue","copilot"],"author":{"name":"Abbas Al-Kaisi","email":"alkaisiabbas@gmail.com"},"license":"AGPL-3.0-only","_id":"@aikaisi/margo-mcp@0.1.2","maintainers":[{"name":"aikaisi","email":"alkaisiabbas@gmail.com"}],"homepage":"https://github.com/aikaisi/margo-mcp#readme","bugs":{"url":"https://github.com/aikaisi/margo-mcp/issues"},"bin":{"margo-mcp":"dist/index.js"},"dist":{"shasum":"51bc5b49206edceef8918ced1c742824df113941","tarball":"https://registry.npmjs.org/@aikaisi/margo-mcp/-/margo-mcp-0.1.2.tgz","fileCount":15,"integrity":"sha512-XHlouNBEHp9mC1QLs3YSKtEMU7aJS4bBZ2DOyQlKw001N0C5VcV7hdHQckl1c1mcuEXSEaFP2hyJXmKlZzvAdw==","signatures":[{"sig":"MEQCIAQA/8UNXXW/A/rMd2cfXKxhnm54PMWMjRC1F13XLYtWAiAcIFrkZV5A8NxSBERUM63Dp+80nfp47xPIK1qeEjmMoA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":90768},"main":"./dist/index.js","engines":{"node":">=18"},"gitHead":"79fa2ce9c4bca66585e49c04fb15fa58408e3104","scripts":{"build":"tsc -p .","clean":"rm -rf dist","start":"node dist/index.js","watch":"tsc -p . --watch","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"aikaisi","email":"alkaisiabbas@gmail.com"},"repository":{"url":"git+https://github.com/aikaisi/margo-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for the Margo VS Code extension — exposes list/add/update/resolve tools so any MCP-compatible AI tool (Claude Code, Cursor, Continue, etc.) can read and write Margo code notes.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.23.0","zod-to-json-schema":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.x"},"_npmOperationalInternal":{"tmp":"tmp/margo-mcp_0.1.2_1776810534367_0.6582810960676704","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@aikaisi/margo-mcp","version":"0.1.3","keywords":["mcp","model-context-protocol","margo","code-notes","annotations","ai","claude","claude-code","cursor","continue","copilot"],"author":{"name":"Abbas Al-Kaisi","email":"alkaisiabbas@gmail.com"},"license":"AGPL-3.0-only","_id":"@aikaisi/margo-mcp@0.1.3","maintainers":[{"name":"aikaisi","email":"alkaisiabbas@gmail.com"}],"homepage":"https://github.com/aikaisi/margo-mcp#readme","bugs":{"url":"https://github.com/aikaisi/margo-mcp/issues"},"bin":{"margo-mcp":"dist/index.js"},"dist":{"shasum":"9cb319727826a2a3e79d0d3d15bbc7e7ef17ecc4","tarball":"https://registry.npmjs.org/@aikaisi/margo-mcp/-/margo-mcp-0.1.3.tgz","fileCount":15,"integrity":"sha512-FozG7o04IoMv79ds9/a5Ta4laVz7NTW6hoeMCq11DJSpYuo/LvxUYFUo1udW9qwpq0+8pkbRbecRAgd92sd3/Q==","signatures":[{"sig":"MEYCIQDnRYYZ1c1ZauAoFvxKX044NnYxufFyaCtQkURe6isnPAIhAPjUOctxgTNd8e+e/7Dosmh7ktYfwMGE6VgzKrMdobgr","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":91853},"main":"./dist/index.js","engines":{"node":">=18"},"gitHead":"d391e0323e4978e0f5d82ce56a89fbb397a6ad2a","scripts":{"build":"tsc -p .","clean":"rm -rf dist","start":"node dist/index.js","watch":"tsc -p . --watch","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"aikaisi","email":"alkaisiabbas@gmail.com"},"repository":{"url":"git+https://github.com/aikaisi/margo-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for the Margo VS Code extension — exposes list/add/update/resolve tools so any MCP-compatible AI tool (Claude Code, Cursor, Continue, etc.) can read and write Margo code notes.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.23.0","zod-to-json-schema":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.x"},"_npmOperationalInternal":{"tmp":"tmp/margo-mcp_0.1.3_1776811404859_0.9956474285970058","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@aikaisi/margo-mcp","version":"0.1.4","keywords":["mcp","model-context-protocol","margo","code-notes","annotations","ai","claude","claude-code","cursor","continue","copilot"],"author":{"name":"Abbas Al-Kaisi","email":"alkaisiabbas@gmail.com"},"license":"AGPL-3.0-only","_id":"@aikaisi/margo-mcp@0.1.4","maintainers":[{"name":"aikaisi","email":"alkaisiabbas@gmail.com"}],"homepage":"https://github.com/aikaisi/margo-mcp#readme","bugs":{"url":"https://github.com/aikaisi/margo-mcp/issues"},"bin":{"margo-mcp":"dist/index.js"},"dist":{"shasum":"6c157609f938ea64d5c2a7e1187c65a1d320614e","tarball":"https://registry.npmjs.org/@aikaisi/margo-mcp/-/margo-mcp-0.1.4.tgz","fileCount":15,"integrity":"sha512-usSNfIp3lLSu3MYuS8eh6VE5+o80mxrCbWci7Bjbcd+JUObohMj5hQbxs5r2ErHIX4J6IwmhtlARd+j2suhwzw==","signatures":[{"sig":"MEUCIQDTWbE4z3CO+b1bbKrJ9huW745Oi30lgd1SFMdbfV01EQIgGC1yuXDSyhxb+QWpDZDHEcVJPxHKrEBiiDz3E5Iwp9s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":91880},"main":"./dist/index.js","engines":{"node":">=18"},"gitHead":"25a5a59b784da2f6c8626d9e65901ef103a0ab2c","scripts":{"build":"tsc -p .","clean":"rm -rf dist","start":"node dist/index.js","watch":"tsc -p . --watch","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"aikaisi","email":"alkaisiabbas@gmail.com"},"repository":{"url":"git+https://github.com/aikaisi/margo-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for the Margo VS Code extension — exposes list/add/update/resolve tools so any MCP-compatible AI tool (Claude Code, Cursor, Continue, etc.) can read and write Margo code notes.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.23.0","zod-to-json-schema":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.x"},"_npmOperationalInternal":{"tmp":"tmp/margo-mcp_0.1.4_1776811642202_0.46341485610312616","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@aikaisi/margo-mcp","version":"0.1.5","keywords":["mcp","model-context-protocol","margo","code-notes","annotations","ai","claude","claude-code","cursor","continue","copilot"],"author":{"name":"Abbas Al-Kaisi","email":"alkaisiabbas@gmail.com"},"license":"AGPL-3.0-only","_id":"@aikaisi/margo-mcp@0.1.5","maintainers":[{"name":"aikaisi","email":"alkaisiabbas@gmail.com"}],"homepage":"https://github.com/aikaisi/margo-mcp#readme","bugs":{"url":"https://github.com/aikaisi/margo-mcp/issues"},"bin":{"margo-mcp":"dist/index.js"},"dist":{"shasum":"b012f5240937b1d2fbdc13b03ce6e3a0578efe90","tarball":"https://registry.npmjs.org/@aikaisi/margo-mcp/-/margo-mcp-0.1.5.tgz","fileCount":15,"integrity":"sha512-Da+HtZ/Bc97lIaEaNsfe9Wl7Qfz2bh/kqIcPL9uc3azSwG4KTvRILoN2GPYGArzELItxwGw+T5q2Vwa9ZUkqfw==","signatures":[{"sig":"MEYCIQCdvThbm+zG579XFCkD5aTZ3hGpwLega2pOmFIRAEBreAIhAO6KPxf0/T9zKig8uw0V8T0jVun02wApsxrHcH2w4PwK","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":91906},"main":"./dist/index.js","engines":{"node":">=18"},"gitHead":"17df70b9f9b266dad26a3738a61729358f60ab8c","scripts":{"build":"tsc -p . && chmod +x dist/index.js","clean":"rm -rf dist","start":"node dist/index.js","watch":"tsc -p . --watch","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"aikaisi","email":"alkaisiabbas@gmail.com"},"repository":{"url":"git+https://github.com/aikaisi/margo-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for the Margo VS Code extension — exposes list/add/update/resolve tools so any MCP-compatible AI tool (Claude Code, Cursor, Continue, etc.) can read and write Margo code notes.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.23.0","zod-to-json-schema":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.x"},"_npmOperationalInternal":{"tmp":"tmp/margo-mcp_0.1.5_1776811871591_0.4550393464582405","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@aikaisi/margo-mcp","version":"0.1.6","description":"MCP server for the Margo VS Code extension — exposes list/add/update/resolve tools so any MCP-compatible AI tool (Claude Code, Cursor, Continue, etc.) can read and write Margo code notes.","license":"AGPL-3.0-only","author":{"name":"Abbas Al-Kaisi","email":"alkaisiabbas@gmail.com"},"repository":{"type":"git","url":"git+https://github.com/aikaisi/margo-mcp.git"},"homepage":"https://github.com/aikaisi/margo-mcp#readme","bugs":{"url":"https://github.com/aikaisi/margo-mcp/issues"},"keywords":["mcp","model-context-protocol","margo","code-notes","annotations","ai","claude","claude-code","cursor","continue","copilot"],"bin":{"margo-mcp":"dist/index.js"},"main":"./dist/index.js","scripts":{"build":"tsc -p . && chmod +x dist/index.js","watch":"tsc -p . --watch","clean":"rm -rf dist","prepublishOnly":"npm run clean && npm run build","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0","zod-to-json-schema":"^3.23.0"},"devDependencies":{"@types/node":"^20.x","typescript":"^5.3.0"},"engines":{"node":">=18"},"gitHead":"eab6344d7133ab2d602f1f5b64e85bd1c366f41f","_id":"@aikaisi/margo-mcp@0.1.6","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-QsBHpK2fQiC41VRCCy5eIhUEqPl1c3qBe8oOBOaWArXW5Z7Ls7RRi6enhGSORob36a8ypNppSM5i5aOUihhjvg==","shasum":"948cfe89e2ffb0d2bb5c368bbf4aa6a5ad0ed65d","tarball":"https://registry.npmjs.org/@aikaisi/margo-mcp/-/margo-mcp-0.1.6.tgz","fileCount":15,"unpackedSize":92013,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCnRCBJKhX5/Gup9bof+OwQcFHi/D7E085QJlOAcnRxsAIhALJebiUudFs2JtOFctgWAd96XtGlJeojrS+ZRNPt3dbx"}]},"_npmUser":{"name":"aikaisi","email":"alkaisiabbas@gmail.com"},"directories":{},"maintainers":[{"name":"aikaisi","email":"alkaisiabbas@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/margo-mcp_0.1.6_1776813365609_0.25112331137869304"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-21T21:43:29.903Z","modified":"2026-04-21T23:16:06.210Z","0.1.0":"2026-04-21T21:43:30.160Z","0.1.2":"2026-04-21T22:28:54.538Z","0.1.3":"2026-04-21T22:43:25.047Z","0.1.4":"2026-04-21T22:47:22.353Z","0.1.5":"2026-04-21T22:51:11.742Z","0.1.6":"2026-04-21T23:16:05.787Z"},"bugs":{"url":"https://github.com/aikaisi/margo-mcp/issues"},"author":{"name":"Abbas Al-Kaisi","email":"alkaisiabbas@gmail.com"},"license":"AGPL-3.0-only","homepage":"https://github.com/aikaisi/margo-mcp#readme","keywords":["mcp","model-context-protocol","margo","code-notes","annotations","ai","claude","claude-code","cursor","continue","copilot"],"repository":{"type":"git","url":"git+https://github.com/aikaisi/margo-mcp.git"},"description":"MCP server for the Margo VS Code extension — exposes list/add/update/resolve tools so any MCP-compatible AI tool (Claude Code, Cursor, Continue, etc.) can read and write Margo code notes.","maintainers":[{"name":"aikaisi","email":"alkaisiabbas@gmail.com"}],"readme":"# margo-mcp\n\nMCP server for the [Margo](https://github.com/aikaisi/margo) VS Code extension.\n\nExposes Margo notes stored in `.notes.json` (team vault) and `.margo/local.notes.json` (local vault) as tools any MCP-compatible AI tool can call — Claude Code, Cursor, Continue, Copilot (via MCP), and others.\n\nNo VS Code dependency. Works in the terminal, in any editor, on a server.\n\n## Use it (zero install — recommended)\n\nRun via `npx` — no global install required. Configure your MCP client to spawn:\n\n```\nnpx -y @aikaisi/margo-mcp\n```\n\n### Claude Code\n\nAdd to `~/.claude/mcp.json` (or run `claude mcp add margo -- npx -y @aikaisi/margo-mcp`):\n\n```json\n{\n  \"mcpServers\": {\n    \"margo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aikaisi/margo-mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nIn `~/.cursor/mcp.json` (or project-level `.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"margo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aikaisi/margo-mcp\"]\n    }\n  }\n}\n```\n\n### Continue / other MCP clients\n\nSame shape — consult each tool's MCP configuration docs for the exact config file location.\n\n## Optional: global install\n\nIf you prefer not to re-fetch on every start:\n\n```bash\nnpm install -g @aikaisi/margo-mcp\n```\n\nThen use `\"command\": \"margo-mcp\"` (no `npx`) in your MCP client config.\n\n## How it finds your notes\n\nWhen an AI tool spawns the server, it walks up from the current working directory looking for `.notes.json` or `.margo/`. If neither exists, it falls back to the nearest `.git` root so the first `add_note` call creates the vault there.\n\n## Tools\n\n### Read\n\n| Tool | Description |\n|------|-------------|\n| `list_notes` | List notes with optional filters (`category`, `priority`, `status`, `vault`, `file`, `text_search`, `limit`). |\n| `get_note` | Fetch a single note by id. |\n| `get_note_with_code` | Fetch a note plus surrounding source lines — prefer this when the AI needs to reason about anchored code. |\n| `get_notes_for_file` | All notes on a given workspace-relative path. |\n| `get_stats` | Counts by category, priority, status, vault. |\n\n### Write\n\n| Tool | Description |\n|------|-------------|\n| `add_note` | Create a note (`file`, `line`, `title`, `text`, optional `category`/`priority`/`vault`/`author`). |\n| `update_note` | Edit `title`, `text`, `category`, and/or `priority`. |\n| `resolve_note` / `reopen_note` | Toggle status. |\n| `delete_note` | Permanently remove. |\n| `move_to_team` / `move_to_local` | Move between vaults. |\n\n## Example AI prompts\n\n- *\"Review the auth module and add BUG notes for anything that looks wrong.\"*\n- *\"List all high-priority open notes and summarize them.\"*\n- *\"Resolve note `1766658158896-klqlob5cs` — I just fixed it.\"*\n- *\"Show me the code around note `...` and explain what it's flagging.\"*\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm start\n```\n\n## License\n\nAGPL-3.0-only. Commercial licensing available; contact alkaisiabbas@gmail.com.\n","readmeFilename":"README.md"}