@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.