Connect an AI client to an Obsidian trading journal to analyze trades, draft reviews, and preview journal edits.
Also known as Cursivez/journalit
- Stars
- 257
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.10.1
- Last commit
- Nov 12, 2026
- License
- —
What is Journalit MCP?
Journalit connects an AI client to an Obsidian trading journal to analyze trades, draft reviews, and preview journal edits.
Summary generated from the project's README
How to install Journalit MCP
Formats verified 10 Nov 2026Install Journalit MCP in Claude Code
$ claude mcp add --transport http journalit https://api.journalit.co/mcpInstall Journalit MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"journalit": {
"url": "https://api.journalit.co/mcp"
}
}
}Install Journalit MCP in VS Code
.vscode/mcp.json
{
"servers": {
"journalit": {
"type": "http",
"url": "https://api.journalit.co/mcp"
}
}
}Install Journalit MCP in Codex
~/.codex/config.toml
[mcp_servers.journalit] url = "https://api.journalit.co/mcp"
Install Journalit MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"journalit": {
"httpUrl": "https://api.journalit.co/mcp"
}
}
}Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearPass
- Package name not close to a popular packageNot checked
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubLocal-first trading journal for Obsidian.
Installation · AI apps (MCP) · Supported brokers · Privacy
Installation
Install Journalit from Obsidian Community Plugins:
- Open Settings → Community Plugins → Browse
- Search for
Journalit - Click Install, then Enable
Community page: https://community.obsidian.md/plugins/journalit
Highlights
- Local-first: core journaling stays inside your Obsidian vault.
- Home View dashboard: draggable widgets + trading heatmap.
- Trading dashboard: track performance and patterns at a glance.
- Prop challenges: track evaluation and funded phases, drawdown, daily loss, profit targets, and payout rules, with firm profiles to set them up.
- Review system (V2): daily → yearly templates with a layout builder.
- Trade Import: backend-powered imports for CSV, spreadsheets, HTML, and broker statements.
- Trade Sync: automatic trade sync for supported brokers.
- AI apps (MCP): connect your AI app to analyse trades, draft reviews and update your journal.
Screenshots
Trading Dashboard
Setups
Accounts & Prop Challenges
Layout Builder
Trade Log & Gallery
Trade Import
AI apps (MCP)
Connect Claude, Claude Code, ChatGPT, Codex, Hermes, Grok Bot or another compatible AI app to your journal using MCP (Model Context Protocol). Ask it to analyse your trades, draft a weekly review or update journal fields without copying notes into a chat.
- Sign in to Journalit in Obsidian. Open Settings → Journalit → AI apps (MCP) and turn on Enable MCP access.
- Add
https://api.journalit.co/mcpas a remote MCP server in your AI app. - Sign in to Journalit when prompted, choose your vault, review the requested permissions and approve the connection.
Keep Obsidian open with Journalit running. Deletions, merges and large changes need your approval by default.
See the AI apps setup guide for client-specific steps, permissions, undo and monthly usage limits.
Supported brokers
Trade Sync creates an ongoing connection. Trade Import reads exported files. Support for one does not imply support for the other.
Automatic Trade Sync
- MetaTrader 4
- Tradovate
- cTrader
- Hyperliquid: watch-only USDC perpetuals
Rithmic Trade Sync is a preview for approved testers only. MetaTrader 5 statements use Trade Import, not FTP-based Trade Sync.
File-based Trade Import
Supported export sources and formats:
- IBKR
- Tradovate
- TopStepX
- TradeZero
- TradingView: Paper Trading order history and Strategy Tester List of Trades (backtests)
- Bybit
- BloFin
- Hyperliquid
- Sierra Chart
- MotiveWave
- FX Replay
- ATAS
- Trading Technologies (TT)
- Rithmic
- MetaTrader 4/5
- DeepCharts: Strategy Report Trade List
- Breakout Terminal:
trades.csv - Merrill Edge: account activity CSV
- PropReports: Executions report for stocks
Use Manual Mapping for other compatible files. See the Trade Import overview and each source's guide for the required export.
Missing your broker? Join Discord and tell us what you want next.
Keywords: obsidian trading journal, trading plugin, trade tracker, obsidian trading template, trading analytics, Trade Import, Trade Sync, prop firm, prop firms, funded account, profit target, trailing drawdown, max drawdown, prop challenge, evaluation, funded phase, payout rules, daily loss limit
AI: MCP, Model Context Protocol, Obsidian MCP, AI trading journal, AI-assisted journaling, Claude, Claude Code, ChatGPT, Codex, Hermes, Grok Bot
Brokers and platforms: MetaTrader, MetaTrader 4, MT4 sync, MetaTrader 5 imports, IBKR, Interactive Brokers, Tradovate, cTrader, Hyperliquid, Rithmic, TopStepX, TradeZero, TradingView, TradingView Strategy Tester, Bybit, BloFin, Sierra Chart, MotiveWave, FX Replay, ATAS, Trading Technologies, DeepCharts, Breakout Terminal, Merrill Edge, PropReports
- How it works (local-first)
- Trade Import overview
- MetaTrader sync overview
- Compare with other journals
- Prop challenges guide
Important disclosures
- Local-first core: core journaling works offline and stores your notes and trades inside your Obsidian vault.
- Account required for full access: a Journalit account is required for authentication-backed and subscription-gated features.
- Paid features: a paid Pro subscription is required for Trade Sync, committing Trade Imports, the Economic Calendar, and prefilled prop-firm profiles. Signed-in free users can analyse and preview Trade Import files.
- Network use: Journalit checks public GitHub release metadata for updates by default without sending vault or account data. Signed-in features may use Journalit services; MT4 sync uses managed FTP, and currency conversion may use a third-party exchange-rate service. See PRIVACY.md.
- Optional AI access: when you enable MCP and authorise an AI app, requested journal data is shared through Journalit services with that app. The AI provider's privacy terms apply to anything it reads. You can disconnect the app or turn off MCP access at any time.
- Trade Import processing: analyse/preview sends your selected file and import options to Journalit. Server-side encrypted diagnostic captures expire after one day for free accounts or 14 days for Pro accounts; stored previews expire after seven days. Compatibility guidance is returned in those responses and displayed locally, with no separate client failure-report upload. See PRIVACY.md.
- Other network diagnostics: existing Tradovate Sync code sends client synchronization diagnostic events as disclosed in PRIVACY.md; this is separate from Trade Import. Upgrade buttons open journalit.co only when clicked, carrying fixed campaign parameters (no identifiers) for server-side attribution.
- Source available, proprietary license: the plugin is proprietary software with reviewable source.
- Privacy details: see PRIVACY.md for data handling, retention, and infrastructure details.
License
This plugin is source-available proprietary software. Source is published for Obsidian review and user inspection, but it is not licensed as open source. See LICENSE for permitted use.
Journalit MCP questions
How do I add Journalit MCP to Claude Code?
Run claude mcp add --transport http journalit https://api.journalit.co/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Journalit MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can an AI app do with my Journalit journal?
It can analyze your trades, draft a weekly review, and update journal fields without copying notes into a chat.
Do I need to approve changes made by the AI?
Deletions, merges and large changes require your approval by default, and edits are previewed first.
Does Obsidian need to be open for MCP access?
Yes, keep Obsidian open with Journalit running so the AI app can reach your vault.
Is Journalit free to use with MCP?
A Journalit account is required for authentication-backed features, and some features like Trade Sync need a paid Pro subscription.