@astramindapp/mcp-journal

@astramindapp/mcp-journal

MCP server exposing MINDJournal as tools for any MCP client (Claude, Claude Code, Claude Desktop, Cursor, custom agents). This server is a thin client of mindjournal-api's /v1 REST surface (../api) — it never talks to Parse/Mongo directly. All 6 tools are fully implemented and verified end-to-end against a live mindjournal-api instance (see journal-client.ts for the HTTP layer).

Tools

Tool	Maps to
log_trade	POST /v1/trades — log a single trade (symbol, side, entry/exit, size, stop/target, tags, notes, setup)
list_trades	GET /v1/trades — query by account / symbol / broker / tag / setup / side / status / date range
get_stats	GET /v1/stats/{summary,equity-curve,calendar,by-symbol,by-setup,by-day}
tag_trade	POST /v1/trades/{id}/tags + PATCH /v1/trades/{id} — add tags, update setup/notes/satisfaction
import_trades	POST /v1/trades/bulk-import — bulk-import a broker CSV/JSON export
get_calendar	GET /v1/stats/calendar — daily P&L calendar view for a month/account

Run locally

cd mcp
cp .env.example .env   # point JOURNAL_API_URL / JOURNAL_API_KEY at the running api service
npm install
npm run dev             # runs src/index.ts directly via tsx (stdio transport)

Build for distribution:

npm run build
npm start

Wiring into an MCP client

Add to the client's MCP server config, e.g.:

{
  "mcpServers": {
    "mindjournal": {
      "command": "node",
      "args": ["/path/to/mindjournal/mcp/dist/index.js"],
      "env": {
        "JOURNAL_API_URL": "http://localhost:8090",
        "JOURNAL_API_KEY": "..."
      }
    }
  }
}

License

MIT — see LICENSE.