@amugona/slog-mcp

Search, read, and capture your slog notes — right from Claude.

한국어 문서는 패키지에 동봉된 README.ko.md 를 참고하세요.

slog is a private-first journal: every note you write is private by default, and you choose what (if anything) becomes public. This MCP server connects MCP clients like Claude Code and Claude Desktop to your slog notes, so you can:

• Ask about your own life. "When did I start running this year?" — Claude searches your notes and answers from what you wrote.
• Capture without switching apps. Mid-conversation, say "save this as a note" and it lands in slog — always as a private note.
• Edit and organize. Update a note's title, body, or series without leaving the chat.

It talks to the slog REST API over HTTPS with your personal API key. It never opens your database directly, and it cannot publish, unpublish, or delete anything — those actions are blocked server-side for API keys, not just omitted from the tool list.

Quick start

1. Get an API key

In slog Studio, go to Settings → API keys and create a key.

The full key (slog_...) is shown only once — copy it right away. If you lose it, use Regenerate on the key row to get a new secret (the old one stops working immediately).

2. Connect your client

Claude Code

claude mcp add slog -e SLOG_API_KEY=slog_your_key_here -- npx -y @amugona/slog-mcp

Claude Desktop — add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "slog": {
      "command": "npx",
      "args": ["-y", "@amugona/slog-mcp"],
      "env": { "SLOG_API_KEY": "slog_your_key_here" }
    }
  }
}

Any other MCP client that supports stdio servers works the same way: run npx -y @amugona/slog-mcp with the SLOG_API_KEY environment variable set.

3. Try it

Start a new conversation and ask something like:

What did I write about coffee last month?

Tools

| Tool | What it does | |---|---| | search_notes | Search notes (space-separated terms, AND match) with date range, series filter, and pagination | | capture_note | Create a new note — always private | | get_note | Read one note in full | | update_note | Edit a note's title, body, series, or draft state | | list_series | List your series |

What it deliberately can't do

Publishing, unpublishing, and deleting are not available through API keys — the slog API rejects those requests no matter what client sends them. The worst an AI mishap could do here is add or edit a private note; it can never expose or destroy one. Use slog Studio for publishing and deleting.

Configuration

| Environment variable | Required | Default | Notes | |---|---|---|---| | SLOG_API_KEY | ✅ | — | Your personal key from Studio → Settings → API keys | | SLOG_API_URL | | https://slog.amgn.app | Point elsewhere for self-hosted or local development (use http://127.0.0.1:3000, not localhost) |

Troubleshooting

• "SLOG_API_KEY 가 필요합니다" on startup — the key environment variable is missing. Check the env block in your client config.
• Authentication errors on every call — the key may have been revoked or regenerated. Issue a new one in Studio and update your config.
• The server prints diagnostics to stderr only; a healthy start logs [slog-mcp] ready — <api url>.

License

MIT