Journalit

Connect Claude, ChatGPT or any MCP client to your Journalit trading journal in Obsidian. Review trades, spot rule breaks, draft reviews.

Servidor MCP hospedado

npx add-mcp 'https://api.journalit.co/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Journalit MCP Server: Connect Claude, ChatGPT & AI Agents | Journalit

Connect Claude, ChatGPT, Grok, Claude Code, Codex, Cursor, OpenCode, Hermes, oh-my-pi, Pi, OpenClaw and other MCP clients to your Journalit vault.

Canonical: https://journalit.co/docs/mcp

Search ⌘ K Getting Started Welcome What's New Installation Quick Start Authentication Journaling Home View Manual Entry Trade Notes Trade Log Setups Session Mode Reviews & Analytics Dashboard Review System Accounts & Prop Firms Account Management Prop Challenges Customization Layout Builder Navigation Sidebar Settings Import & Integrations Trade Import MCP Trade Sync Guides Broker Export Guides Download Sign In MCP

MCP

Copy Markdown Open Continue with Journalit Trading platforms Compare direct sync and supported imports. CSV trade import Import broker exports into your journal. Obsidian plugin Use Journalit inside your vault. Trading journal template See the default vault structure. MetaTrader journal Use MT4 sync or import MetaTrader statements. Trade Import Previous Page Overview Next Page

On this page

  • Set up Turn on MCP access in Obsidian Add Journalit to your MCP client Approve on journalit.co What an MCP client can do How it works MCP settings in Journalit Full access, usage and activity Approvals and undo Approvals AI agent activity Full access Undo an agent change Consent and connections The consent screen Permissions The rest of the screen Choosing a vault The AI & Usage page Plans and allowance Your data and privacy Troubleshooting Common problems Agent tools Connect your AI assistant or agent to your Journalit journal. It can query your trades, run analytics, tag trades and draft reviews in your real vault, with the same rules the plugin applies when you do it by hand. Works with Claude, ChatGPT, Grok, Claude Code, Codex, Cursor, OpenCode, Hermes, oh-my-pi, Pi, OpenClaw and any other client that supports remote MCP servers with OAuth. Available on every plan. https://api.journalit.co/mcp Copy One URL for every client. You sign in with your Journalit account, so there is no API key to manage.

Set up

Turn on MCP access in Obsidian

Open Settings → Journalit → Connections → MCP and tick Enable MCP access . Status changes to Connected . Keep Obsidian open while you use your MCP client: Journalit's tools run inside it. See MCP settings for screenshots and the other controls.

Add Journalit to your MCP client

Pick your client. Menus in third-party apps change often, so each tab links to the app's own guide. Claude ChatGPT Grok Claude Code Codex Cursor OpenCode Hermes oh-my-pi Pi OpenClaw Other Works in Claude on the web, desktop and mobile. Open Customize → Connectors . In some versions this is Settings → Connectors .

Select + Add , then Add custom connector .

Enter a name such as Journalit and paste this URL: https://api.journalit.co/mcp Copy

Continue, then sign in to Journalit and approve access.

In a chat, select + → Connectors and make sure Journalit is turned on for that conversation. On Team and Enterprise plans, an organisation owner adds the connector under Organization settings → Connectors , and members then select Connect on it. See Claude's custom connector guide .

Approve on journalit.co

The sign-in ends on Journalit's consent screen. Check that the app name matches the one you just added, choose the vault, and select Approve . See The consent screen for what each permission means. Try it Ask your MCP client something like "Using Journalit, how did my trades do last week?" A good first answer confirms the connection, the vault and your allowance are all working. If the app can't reach Journalit, see Troubleshooting .

What an MCP client can do

Read your journal

Query trades, open a single trade, read reviews, look at your trade and review images, and calculate analytics such as win rate, expectancy and P&L by setup or ticker.

Make changes

Create and edit trades, reviews, image tags and notes, accounts, setups, tags, custom fields and other configuration. Every change is previewed before it is committed. Trades accept everything the trade form does, including direct P&L, costs, currency and hindsight fields, star ratings, and image files such as chart screenshots. Trade entry settings can be set too, including your favourite accounts, the default symbol, and hiding dollar amounts in R mode.

Run syncs

Start Trade Sync and other connected integrations, and check their status.

Open views

Open a trade, review or Journalit view in Obsidian so you can see what the agent is talking about, including the Dashboard with filters applied or a saved comparison. The MCP client only gets the permissions you approve when you connect it. See The consent screen for what each permission group covers.

How it works

The client connects to Journalit

You add the MCP server URL to your client. It opens journalit.co, where you sign in, review the permissions and choose a vault.

Journalit runs the request in Obsidian

Obsidian must be open with Enable MCP access on for that vault. If it is closed, the client is told the vault is offline and can't read or change anything.

Changes land in your vault

Changes are written to your notes exactly as if you made them in Journalit. Deletions, merges and large changes wait for your approval unless you give agents full access.

MCP settings in Journalit

AI access is switched on per vault in Settings → Journalit → Connections → MCP . The same screen shows the MCP server URL with short steps for Claude, ChatGPT and Claude Code, the approval controls and your monthly AI tool calls. With Enable MCP access ticked, Status shows Connected and the Connect an MCP client block shows the URL with a Copy button.

Full access, usage and activity

Below the connect block, three rows control what agents may do and show what they have done.

Full access

Off by default. When off, deletions, merges and large changes wait for your approval. When on, agents make every change without asking.

Monthly usage

AI tool calls used this month, your plan's limit and the reset date. Manage apps opens the AI & Usage page on journalit.co.

AI agent activity

Approve or deny waiting requests, and review or undo recent agent changes. Turning AI access off Untick Enable MCP access to stop every MCP client from using this vault. To remove one app's access instead, disconnect it on the AI & Usage page .

Approvals and undo

An AI agent can change your journal, so Journalit keeps the risky changes in your hands. Routine edits go straight through, while deletions, merges, failing a prop challenge and large rewrites wait until you approve them. Most agent changes can also be undone afterwards.

Approvals

Every change starts as a preview. The agent sees what would happen and can show you before it commits. Previews never need approval and never change your vault. When the agent commits, Journalit applies the change straight away unless it is one of these:

Deletions

Deleting journal items, configuration or list entries, and removing entries or images from a review. The full list is below.

Merges

Merging one tag, mistake or event into another.

Failing a prop challenge

Marking a prop challenge as failed.

Large changes

Any change that touches more than 25 notes, such as renaming a tag used across many trades. The deletions that wait cover trades and accounts; setups, custom fields, session workflows, review templates, and dashboard and home layouts; tags, mistakes, events, account types and session log tags; a single account transaction or prop challenge cost; and session log entries or images removed from a review. Without full access, these wait for you. Journalit shows a notice in Obsidian, and the request appears under Waiting for you in AI agent activity. Select Approve to let the agent finish, or Deny to refuse it. After you approve, the agent commits again and the change is applied. If the agent has stopped waiting, ask it to try the change again. If a request doesn't show up, see An approval request never appeared .

AI agent activity

Open it from Settings → Journalit → Connections → MCP → AI agent activity → Open , or run Open AI agent activity from the command palette.

Waiting for you

Requests that need your approval, with what they change and how many notes they touch.

Recent agent changes

What agents changed, with the time and an Undo button where the change can be reversed.

Full access

Full access in Settings → Journalit → Connections → MCP lets agents make every change without asking, including deletions, merges, failing a prop challenge and large rewrites.

  • Turning it on doesn't approve anything already waiting. Those requests stay in AI agent activity until you approve or deny them.
  • It is a setting of this vault, so it covers every MCP client connected to it. Only for agents you trust With full access, an agent can delete and change trades, accounts, reviews and settings, and rewrite many notes, without your approval. Keep it off unless you trust the agent and the instructions you give it.

Undo an agent change

In AI agent activity, select Undo next to a recent change, then confirm. Undo covers items the agent created, and its edits to trades, accounts, setups, custom fields, reviews, image tags and notes, session log entries and session log tags. It reverses only what the agent changed, not the whole note. If you have edited the note since, Journalit doesn't undo that change and leaves your edit in place. Changes that can't be undone Renames, merges, deletions and changes that rewrite many notes can't be undone from AI agent activity. Deletions, merges and large rewrites wait for your approval unless you give agents full access, so check them before you approve.

Consent and connections

You decide what each MCP client can do before it touches your journal. The consent screen on journalit.co sets that up when you connect, and the AI & Usage page lets you review and remove connections afterwards.

The consent screen

When an MCP client connects, it opens journalit.co. After you sign in, you see the app's name, the domain it identifies itself with, and what it is asking for. Some apps, such as oh-my-pi, register themselves with Journalit instead of proving a domain. Their consent screen says Not verified and shows where approving sends you, for example an app on this computer. Only approve if you just added that app yourself. Permissions Permissions are grouped by what they let the app do. Expand a group to see the individual permissions inside it.

View journal data

Read-only. Read trades, reviews, performance analytics, connected integrations and Journalit configuration.

Change journal content and settings

Read and write. Create and change trades, reviews and Journalit configuration such as accounts, setups, templates, custom fields and tag lists.

Run broker and data integrations

Elevated access. Start syncs and imports, which contact your connected brokers and data providers and can add data to your vault.

Open views in Obsidian

Changes your screen. Open notes and switch views in the chosen vault while you are working. The rest of the screen

Stay connected until you disconnect it

The app can renew its access without asking you again. Disconnect it from AI & Usage at any time.

Uses your monthly AI tool calls

A reminder of your plan's allowance: Free includes 100 AI tool calls a month and Pro includes more (1,000).

Vault access

The vault this connection can use. Each connection works with one vault.

Connection details

The client name and public client ID, for checking exactly which app is asking. Only approve what you started Approve only if you started this connection yourself, from an MCP client you recognise. If you didn't, select Cancel . Choosing a vault The list shows the vaults where you have turned on MCP access. Pick the vault you want the MCP client to work in. To move an app to a different vault later, disconnect it and connect it again, choosing the other vault.

The AI & Usage page

Open AI & Usage from the journalit.co dashboard sidebar, or select Manage apps in Journalit's MCP settings.

Usage this month

AI tool calls completed this month against your plan's limit, calls still pending, and when usage resets.

Connected AI clients

Each app with its domain, vault, the permissions you granted, when it connected and when it was last used.

Disconnect

Removes the app's access to that vault straight away. You can connect it again later with a new approval. Stopping every app at once To stop all MCP clients from using a vault, untick Enable MCP access in that vault. See Turn on Enable MCP access .

Plans and allowance

AI access is available on every plan. Each month includes an allowance of AI tool calls: Plan AI tool calls per month Free 100 Pro 1,000

What counts

Other tool calls, such as reading trades, reviews and analytics, and committing changes.

What doesn't count

Inspection, previews, navigation, image views and docs lookups. Committing the same change again isn't charged twice.

When it resets

Usage resets at the start of the 1st of each month (UTC).

When you reach the limit

Reading and committing stop until the reset. Inspection, previews, navigation and image views keep working. Track usage in Journalit's settings under Monthly usage , or on the AI & Usage page on journalit.co.

Your data and privacy

It's your data

Your journal stays in your vault. The MCP client works through Journalit rather than reading your files directly.

You choose the vault

Each connection is tied to the one vault you pick on the consent screen.

Disconnect at any time

Remove an MCP client from the AI & Usage page on journalit.co, or turn off MCP access in Journalit to stop every MCP client using that vault. What the MCP client sees Anything the MCP client reads, such as trade details or review text, is sent to that AI provider as part of your conversation. Their privacy terms apply to it.

Troubleshooting

Most MCP client problems come down to three things: Obsidian isn't running, the connection points at the wrong vault, or the month's allowance has run out. Start with the message your MCP client reports.

Common problems

"MCP header mismatch" (-32020) or "Unsupported protocol version" (-32022)

"Journalit can't reach this vault right now"

"This Journalit version doesn't support…"

Sign-in keeps looping

"Monthly tool call allowance reached"

An approval request never appeared

The agent can't find a tag

The agent is working in the wrong vault

Still stuck? Ask on Discord or email contact@journalit.co with the MCP client you use and the exact message it shows.

Agent tools

MCP clients see these tools. You don't call them yourself, but the names help when you read an agent's activity or ask it what it did. Tool What it does inspect_journal Checks the connection, vault, accounts and integrations available to the agent. inspect_configuration Reads setups, templates, layouts, workflows, custom fields and other configuration. query_trades Lists and filters trades. get_trade Reads one trade in detail, including the tags and notes on its images. evaluate_trades Calculates analytics across a set of trades. analyze_behavior Finds behaviour patterns: what each mistake costs, results after losing streaks, and overtrading by trade number in the day. get_premarket_brief Builds a brief for a trading day: your last review and lessons, goals, recent mistakes, tilt signal, best and worst setup and hour, and prop challenge progress. get_review Reads one daily, weekly, monthly, quarterly or yearly review, including the tags and notes on its images. view_image Shows the agent one trade or review image so it can read the chart. Images larger than 2,000 px are resized. It doesn't use your allowance. describe_actions Lists the changes the agent is allowed to make. preview_changes Previews changes without writing to your vault. apply_changes Commits a previewed change, including tags and notes on trade and review images, subject to your permissions and approvals. get_integration_status Checks available integrations and their status. run_integration Starts advertised Trade Sync and other integration operations. navigate_journalit Opens a trade, review or view in Obsidian. list_docs , grep_docs , read_doc Search and read this documentation. report_feedback Sends the Journalit team a report when a tool fails, returns something wrong or can't do what you asked. It doesn't change your journal or use your allowance. get_trade and get_review also give each image's location in your vault, such as Journalit/Media/chart.png . An agent that runs on your computer and can open your vault folder can use it to work with the original file. MCP clients in the cloud, such as ChatGPT, can't open it and use view_image instead.