ScreenJournal

Connecting AI Tools (MCP)

ScreenJournal ships an MCP (Model Context Protocol) server, so AI assistants you already use — Claude, ChatGPT, or any MCP-enabled tool — can query your team's work record directly: what people worked on, where the hours went, and how something was done. Every answer is scoped to exactly what your role can already see in the dashboard, and no more. Access is read-only: no assistant can change anything in ScreenJournal.

Open MCP in the sidebar. The page has two tabs: Connect — pick your assistant and follow its setup steps — and Connected — see and manage what's already linked.

Your connection link

Every assistant needs the same thing: your ScreenJournal connection link. The Connect tab has a copy button next to it, whichever assistant you pick:

https://mcp-beta.screenjournal.ai/mcp

Connect from Claude

Set this up on a computer — it takes about a minute. Once connected, it works in the Claude mobile app too.

  1. Open claude.ai on a computer and sign in, then go to Settings → Connectors.
  2. Click Add custom connector.
  3. Paste your ScreenJournal connection link and click Add.
  4. Click Connect, and sign in to ScreenJournal when asked.

Connect from ChatGPT

Set this up on a computer. Requires a paid ChatGPT plan (Plus, Pro, Business, Enterprise or Edu).

  1. Open chatgpt.com on a computer and sign in.
  2. Turn on Developer mode.
  3. Open your plugins, then click the + icon in the top right of the page.
  4. Paste your ScreenJournal connection link as the MCP server URL, choose OAuth, and sign in to ScreenJournal when asked.

ChatGPT restricts connectors that can change data to Business, Enterprise and Edu plans. ScreenJournal is read-only, so any paid plan works.

Connect from any other assistant

Choose Other on the Connect tab. ScreenJournal works with any AI assistant that supports remote MCP servers. Open your assistant's settings and look for wherever it lets you add a custom connector — assistants name this differently, so look for "connectors", "apps", "plugins", or "integrations". Paste in your ScreenJournal connection link and sign in to ScreenJournal when asked.

If someone else manages your tools, Email your IT admin the setup details drafts a message with everything they need.

Check that it worked

Under the steps, Check my connection watches for your assistant's first sign-in or first query and confirms it. It also offers ready-made prompts to copy into your assistant, such as "Summarize my activity this week", "What apps did I use most yesterday?" and "When did I start and finish work each day this week?". A Troubleshooting section covers the usual snags: not seeing "Add custom connector" in Claude, Claude connected but not using ScreenJournal, and Developer mode missing in ChatGPT.

Claude Code (advanced, for developers)

If you use Claude Code from the command line, connect ScreenJournal there directly instead of through claude.ai:

  1. Add the server (--scope user makes it available in all your projects, not just the current folder):

    claude mcp add --transport http --scope user screenjournal https://mcp-beta.screenjournal.ai/mcp

  2. Start a fresh Claude Code session so it picks up the new server, then run /mcp, select screenjournal, and choose Authenticate. Sign in and approve in the browser that opens — your login is stored securely and refreshes automatically.

  3. Run /mcp again to confirm the server shows as connected, then chat normally — try "Using ScreenJournal MCP, what am I working on today?" and approve the tool the first time it's used.

Managing your connections

The Connected tab lists every assistant you've linked, when it was connected, whether it has actually been used (Active or Never used) and a Disconnect button for each. Disconnecting an assistant stops its access to ScreenJournal within about 15 minutes.

Authorisation and permissions

Connecting opens ScreenJournal's consent screen in your browser — sign in with your normal account and approve the client. Your account must belong to an organisation — ask your admin to invite you if it doesn't. Once connected, queries run under the same role permissions as the app: you can never see more through MCP than you can in ScreenJournal itself, and a deactivated account loses MCP access along with the desktop app.