{"_id":"@amugona/slog-mcp","name":"@amugona/slog-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@amugona/slog-mcp","version":"0.1.0","description":"slog MCP server — search, read and capture your private slog notes from Claude and other MCP clients","license":"MIT","type":"module","main":"./dist/index.js","bin":{"slog-mcp":"dist/index.js"},"publishConfig":{"access":"public"},"keywords":["mcp","modelcontextprotocol","slog","notes","journal"],"engines":{"node":">=20"},"dependencies":{"@modelcontextprotocol/server":"^2.0.0","zod":"^4.4.3"},"devDependencies":{"@modelcontextprotocol/client":"^2.0.0","@types/node":"^22.10.0","typescript":"^5.7.2","vitest":"^2.1.8","@amgn/types":"0.0.0"},"scripts":{"build":"tsc -p tsconfig.json","dev":"tsc -p tsconfig.json --watch","clean":"rm -rf dist .turbo *.tsbuildinfo","typecheck":"tsc --noEmit","test":"vitest run","test:watch":"vitest"},"_id":"@amugona/slog-mcp@0.1.0","_integrity":"sha512-gZawO8RnjYdaMHaBBmVQTYI6D8Uu1VfN3QmcpoTt86CFKkwmVIcLnUicupBxG85GfJj/wDnp1jt9Yy4gwAX4pA==","_resolved":"/private/var/folders/8r/bjzjl28n6t91xtsf8wvgndnr0000gn/T/138a49df4bded95ee26ab3ef41a0cf0d/amugona-slog-mcp-0.1.0.tgz","_from":"file:amugona-slog-mcp-0.1.0.tgz","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-gZawO8RnjYdaMHaBBmVQTYI6D8Uu1VfN3QmcpoTt86CFKkwmVIcLnUicupBxG85GfJj/wDnp1jt9Yy4gwAX4pA==","shasum":"2d638a30e89dc004f919e70517c1568e5e81436e","tarball":"https://registry.npmjs.org/@amugona/slog-mcp/-/slog-mcp-0.1.0.tgz","fileCount":14,"unpackedSize":38693,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHd3+YhWhzFqewqY4hxiGVwmqYhxxXsvzFF+bDX5VVNKAiA8+8CVycaldDEsH6/oevCCLOwsCNjVWstPeDQJpap7wQ=="}]},"_npmUser":{"name":"ordinary.yobi","email":"ordinary.yobi@gmail.com"},"directories":{},"maintainers":[{"name":"ordinary.yobi","email":"ordinary.yobi@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/slog-mcp_0.1.0_1785521352291_0.18804509658840018"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-31T18:09:11.771Z","0.1.0":"2026-07-31T18:09:12.427Z","modified":"2026-07-31T18:09:12.684Z"},"maintainers":[{"name":"ordinary.yobi","email":"ordinary.yobi@gmail.com"}],"description":"slog MCP server — search, read and capture your private slog notes from Claude and other MCP clients","keywords":["mcp","modelcontextprotocol","slog","notes","journal"],"license":"MIT","readme":"# @amugona/slog-mcp\n\n**Search, read, and capture your [slog](https://slog.amgn.app) notes — right from Claude.**\n\n*한국어 문서는 패키지에 동봉된 [README.ko.md](./README.ko.md) 를 참고하세요.*\n\nslog is a private-first journal: every note you write is private by default, and you choose\nwhat (if anything) becomes public. This MCP server connects MCP clients like Claude Code and\nClaude Desktop to your slog notes, so you can:\n\n- **Ask about your own life.** \"When did I start running this year?\" — Claude searches your\n  notes and answers from what *you* wrote.\n- **Capture without switching apps.** Mid-conversation, say \"save this as a note\" and it lands\n  in slog — always as a private note.\n- **Edit and organize.** Update a note's title, body, or series without leaving the chat.\n\nIt talks to the slog REST API over HTTPS with your personal API key. It never opens your\ndatabase directly, and it *cannot* publish, unpublish, or delete anything — those actions are\nblocked server-side for API keys, not just omitted from the tool list.\n\n## Quick start\n\n### 1. Get an API key\n\nIn slog Studio, go to **Settings → API keys** and create a key.\n\nThe full key (`slog_...`) is shown **only once** — copy it right away. If you lose it, use\n**Regenerate** on the key row to get a new secret (the old one stops working immediately).\n\n### 2. Connect your client\n\n**Claude Code**\n\n```bash\nclaude mcp add slog -e SLOG_API_KEY=slog_your_key_here -- npx -y @amugona/slog-mcp\n```\n\n**Claude Desktop** — add to `claude_desktop_config.json`\n(Settings → Developer → Edit Config):\n\n```json\n{\n  \"mcpServers\": {\n    \"slog\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@amugona/slog-mcp\"],\n      \"env\": { \"SLOG_API_KEY\": \"slog_your_key_here\" }\n    }\n  }\n}\n```\n\nAny other MCP client that supports stdio servers works the same way: run `npx -y @amugona/slog-mcp`\nwith the `SLOG_API_KEY` environment variable set.\n\n### 3. Try it\n\nStart a new conversation and ask something like:\n\n> What did I write about coffee last month?\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `search_notes` | Search notes (space-separated terms, AND match) with date range, series filter, and pagination |\n| `capture_note` | Create a new note — **always private** |\n| `get_note` | Read one note in full |\n| `update_note` | Edit a note's title, body, series, or draft state |\n| `list_series` | List your series |\n\n### What it deliberately can't do\n\nPublishing, unpublishing, and deleting are **not available** through API keys — the slog API\nrejects those requests no matter what client sends them. The worst an AI mishap could do here\nis add or edit a private note; it can never expose or destroy one. Use slog Studio for\npublishing and deleting.\n\n## Configuration\n\n| Environment variable | Required | Default | Notes |\n|---|---|---|---|\n| `SLOG_API_KEY` | ✅ | — | Your personal key from Studio → Settings → API keys |\n| `SLOG_API_URL` | | `https://slog.amgn.app` | Point elsewhere for self-hosted or local development (use `http://127.0.0.1:3000`, not `localhost`) |\n\n## Troubleshooting\n\n- **\"SLOG_API_KEY 가 필요합니다\"** on startup — the key environment variable is missing.\n  Check the `env` block in your client config.\n- **Authentication errors on every call** — the key may have been revoked or regenerated.\n  Issue a new one in Studio and update your config.\n- The server prints diagnostics to stderr only; a healthy start logs\n  `[slog-mcp] ready — <api url>`.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-7a4edf8f4f1cbf5ca507ce888b5bef48"}