Get Started

Workjournal connects to your AI assistant as an Open Agent Skill, a remote MCP server, or a local MCP server — depending on which client you use.

1. Sign up

Go to app.workjournal.pro and create an account. You can sign up with email or a social provider.

2. Connect your AI client

Pick your client and platform below — the instructions update accordingly. Don't see your client? Pick Other.

Client Platform

Claude (claude.ai) — remote MCP via Connectors

claude.ai supports remote MCP servers through the Connectors feature on every paid plan (Pro / Max / Team / Enterprise).

1. Open Connectors

In claude.ai, go to Settings → Connectors → Add custom connector.

2. Add Workjournal

Name: Workjournal
Remote MCP server URL: https://mcp.workjournal.pro

3. Authorize

Claude opens the Workjournal login page in a new tab. Sign in and click Approve — you’re redirected back and the connector is live.

4. Use it

Toggle Workjournal on under the + menu in any conversation, or ask “log this decision to my work journal.” Claude calls the Workjournal tools directly.

Claude Desktop — remote MCP via Connectors

Claude Desktop supports the same Connectors feature as claude.ai. Any connector you add on the web is available on desktop and vice versa.

1. Open Connectors

Settings → Connectors → Add custom connector.

2. Add Workjournal

Name: Workjournal
Remote MCP server URL: https://mcp.workjournal.pro

3. Authorize

Claude opens the Workjournal login page in your default browser. Sign in and click Approve — you’re redirected back and the connector is live.

4. Use it

Toggle Workjournal on under the + menu in any conversation, or ask “log this decision to my work journal.” Claude calls the Workjournal tools directly.

If you’d rather run the server locally over stdio, switch the tab above to Local MCP.

Claude Desktop — local MCP server

Claude Desktop runs MCP servers locally over stdio. Install the Workjournal MCP package and add one entry to the Claude Desktop config.

1. Open the Claude Desktop config file

OS	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

2. Add the Workjournal server

{
  "mcpServers": {
    "workjournal": {
      "command": "npx",
      "args": ["-y", "@workjournal/mcp-server"]
    }
  }
}

3. Restart Claude Desktop

Claude will start the server automatically. The first time you invoke a Workjournal tool it will ask you to authorize — a browser window opens, you sign in, paste the returned code back into Claude, and you’re set.

Claude Code — plugin

The Workjournal plugin bundles the skill, CLI commands, and configuration as one drop-in install.

Install

# In Claude Code: add the marketplace, then install the plugin
/plugin marketplace add workjournal-pro/marketplace
/plugin install workjournal@workjournal

Authenticate

/workjournal login

The agent opens a browser window, you approve, and it pastes the code back automatically. Credentials are stored at ~/.config/workjournal/credentials.json (or the platform equivalent — see /docs/cli-tool-auth-workflow).

Start using

/workjournal              # write a new entry
/workjournal last 3       # review recent entries
/workjournal check        # find relevant context
/workjournal search auth  # full-text search

Claude Code — Open Agent Skill

The Workjournal skill works with any agent that supports the Open Agent Skills format — Claude Code, Cursor, Copilot, Gemini CLI, and more.

Install from marketplace

If your agent has a skill marketplace, search for Workjournal and install.

Install from GitHub

curl -sL https://github.com/workjournal-pro/skill/releases/latest/download/skill.zip \
  -o /tmp/workjournal-skill.zip
unzip /tmp/workjournal-skill.zip -d skills/workjournal

Authenticate

/workjournal login

The skill prints a URL — open it in any browser, click Approve, copy the 8-character code, and paste it back. Works in local terminals, SSH, dev containers, and CI.

Start journaling

/workjournal              # write a new entry
/workjournal last 3       # view recent entries
/workjournal search <q>   # search past entries
/workjournal check        # find relevant context

See the commands reference for the full list.

Claude Code — CLI

If you don’t want the skill layer, the underlying CLI works directly. Claude Code can shell out to workjournal like any other command.

Install

npm install -g @workjournal/cli

Authenticate

workjournal auth login

Opens a browser flow, prints a code, and stores credentials at ~/.config/workjournal/credentials.json (or the platform equivalent — see /docs/cli-tool-auth-workflow).

Use

workjournal workspaces list
workjournal journals list <workspaceSlug>
workjournal journals select <workspaceSlug> <journalSlug>
workjournal entries last <workspaceSlug> <journalSlug> 3
workjournal entries write <workspaceSlug> <journalSlug> -t "Title" -s "Summary" -b "Details"

Full CLI reference: /docs/commands.

Codex — plugin

The Workjournal Codex plugin bundles the skill and command reference as one install. The skill shells out to the Workjournal CLI for authentication and API calls, matching the Claude Code plugin flow.

Install

# In your terminal: add the marketplace, then install the plugin
codex plugin marketplace add workjournal-pro/marketplace
codex plugin add workjournal@workjournal

Start a new Codex thread after installation so the Workjournal skill is loaded.

Authenticate

Ask Codex: log in to Workjournal

Codex drives the browser-based OAuth flow through the skill. Open the URL, approve access, copy the 8-character code, and paste it back into the thread. Credentials are stored at ~/.config/workjournal/credentials.json (or the platform equivalent — see /docs/cli-tool-auth-workflow).

Start using

Ask Codex: log what we accomplished to Workjournal
Ask Codex: show the latest Workjournal entry
Ask Codex: search Workjournal for auth decisions
Ask Codex: check Workjournal for relevant context

Codex — Open Agent Skill

Codex loads Workjournal through the installed plugin. The plugin packages the same CLI-backed Workjournal skill used by Claude Code, so Codex can write entries, search past work, and review recent context without an MCP server.

Recommended install

codex plugin marketplace add workjournal-pro/marketplace
codex plugin add workjournal@workjournal

Start a new Codex thread after installation so the skill is available.

Authenticate

Ask Codex: log in to Workjournal

The skill prints a URL — open it in any browser, click Approve, copy the 8-character code, and paste it back. Works in local terminals, SSH, dev containers, and CI.

Start journaling

Ask Codex: write a Workjournal entry for this session
Ask Codex: show the last 3 Workjournal entries
Ask Codex: search Workjournal for <query>
Ask Codex: check Workjournal for relevant context

See the commands reference for the underlying CLI commands.

Codex — CLI

If you do not want the plugin or skill layer, Codex can still shell out to the underlying Workjournal CLI directly.

Install

npm install -g @workjournal/cli

Authenticate

workjournal auth login

Opens a browser flow, prints a code, and stores credentials at ~/.config/workjournal/credentials.json (or the platform equivalent — see /docs/cli-tool-auth-workflow).

Use

workjournal workspaces list
workjournal journals list <workspaceSlug>
workjournal journals select <workspaceSlug> <journalSlug>
workjournal entries last <workspaceSlug> <journalSlug> 3
workjournal entries write <workspaceSlug> <journalSlug> -t "Title" -s "Summary" -b "Details"

Full CLI reference: /docs/commands.

ChatGPT (web) — remote MCP via Connectors

ChatGPT supports remote MCP servers through the Connectors feature. Workjournal is an approved app in the OpenAI app directory, so no Developer Mode toggle is needed.

1. Add Workjournal

Open Workjournal in the app directory and click Connect — or in ChatGPT go to Settings → Apps & Connectors, search for Workjournal, and add it from there.

2. Authorize

ChatGPT redirects to the Workjournal login page. Sign in and click Approve. You’ll be sent back automatically and the connector will appear in your connector list.

3. Use it

Mention @workjournal in any chat, or ask “log this decision to my work journal.” With the connector enabled you get the full toolset — search and fetch for retrieval, plus creating entries and managing journals.

ChatGPT (web) — Custom GPT

The Workjournal Custom GPT is the no-toggle path for ChatGPT users. Anyone can open it from the GPT Store, sign in once, and write entries from chat.

1. Open the Workjournal GPT

Visit the Workjournal GPT or search “Workjournal” in Explore GPTs inside ChatGPT.

2. Sign in

Click Start chat → the GPT asks to connect to your Workjournal account. Approve the OAuth screen at app.workjournal.pro/authorize.

3. Use it

Tell the GPT what you want to log: “log that I shipped the v2 cron parser today”. The GPT calls createEntry against your default journal. Ask “what did I work on last week?” to search past entries.

The Custom GPT exposes a curated 15-operation surface (entries, journals, tags, export). For the full ~35-tool catalog — including prompts and contributor management — use the Remote MCP tab.

ChatGPT desktop — remote MCP via Connectors

The ChatGPT desktop app uses the same Connectors feature as the web app. Any connector you add on the web is available on desktop and vice versa. Workjournal is an approved app in the OpenAI app directory, so no Developer Mode toggle is needed.

1. Add Workjournal

Open Workjournal in the app directory and click Connect — or go to Settings → Apps & Connectors, search for Workjournal, and add it from there.

2. Authorize

ChatGPT opens the Workjournal login page in your default browser. Sign in and click Approve — you’re redirected back and the connector is live.

3. Use it

ChatGPT (mobile) — remote MCP

The ChatGPT mobile app uses the same Connector list as ChatGPT web and desktop. Set up Workjournal on web first — the mobile app can’t run the OAuth flow itself, but it will pick up an existing connector and let you call its tools.

1. Set up on web or desktop first

Follow the ChatGPT (web) or ChatGPT (desktop) steps to add Workjournal once — it’s an approved app in the OpenAI app directory, so it’s one search away under Settings → Apps & Connectors. The mobile app picks up the connector once it exists.

2. Use it from mobile

Open ChatGPT on your phone. The Workjournal connector shows up under your enabled connectors automatically — no extra mobile config.

In any conversation, mention @workjournal or ask “log this decision to my work journal.” ChatGPT calls the tools through the same hosted MCP endpoint.

Note: signing in to the connector for the first time from the mobile app isn’t supported. If the connector is missing on mobile, finish step 1 on web or desktop and re-open the app.

Perplexity (web) — remote MCP

Perplexity supports remote MCP servers in Spaces and directly in Pro settings.

1. Open MCP settings

Perplexity → Settings → Connectors (or, inside a Space, Connectors).

2. Add Workjournal

Name: Workjournal
MCP server URL: https://mcp.workjournal.pro

3. Authorize

Perplexity opens the Workjournal login page. Sign in and click Approve. You’re returned to Perplexity with the connector active.

4. Use it

In any Perplexity thread: “Use workjournal to log today’s decisions” — or just ask a question that implies journal access and Perplexity will call the tools.

Perplexity desktop — remote MCP

The Perplexity desktop app shares its connector list with the web app. Configure once and it’s available everywhere.

1. Open Connectors

Settings → Connectors → Add a connector.

2. Add Workjournal

Name: Workjournal
MCP server URL: https://mcp.workjournal.pro

3. Authorize

Perplexity opens the Workjournal login flow in your default browser. Sign in and click Approve.

4. Use it

Ask Perplexity to log, search, or summarize journal entries — it’ll call the tools as needed.

Grok (web) — remote MCP

Grok supports remote MCP servers via its Connectors integration.

1. Open Connectors

In Grok, open Settings → Connectors → Add a connector.

2. Add Workjournal

Name: Workjournal
MCP server URL: https://mcp.workjournal.pro

3. Authorize

Grok opens the Workjournal login page. Sign in and click Approve. You’re returned to Grok with the connector active.

4. Use it

In any Grok conversation, ask “log this decision to my work journal” — or just mention something that implies journal access and Grok will call the tools.

Grok (mobile) — remote MCP

The standalone Grok mobile app (iOS / Android) supports remote MCP connectors.

Workjournal works in the standalone Grok app — not in the Grok chat embedded in X.com, which doesn’t expose connectors today.

1. Open Connectors

In the Grok app, open Settings → Connectors → Add a connector.

2. Add Workjournal

Name: Workjournal
MCP server URL: https://mcp.workjournal.pro

3. Authorize

Grok opens the Workjournal login page in an in-app browser. Sign in and click Approve. You’re returned to Grok with the connector active.

4. Use it

In any Grok conversation, ask “log this decision to my work journal” — or just mention something that implies journal access and Grok will call the tools.

Opera Neon (desktop) — remote MCP

Opera Neon supports remote MCP servers through its MCP Servers settings; the tools are used by Neon Do, the browser’s AI assistant.

1. Open MCP Servers

From the Neon start page, open the menu → Settings → MCP Servers.

2. Add Workjournal

Name: Workjournal
MCP server URL: https://mcp.workjournal.pro

3. Authorize

Neon opens the Workjournal login page. Sign in and click Approve. Back in settings, a green Authenticated chip appears on the server entry.

4. Use it

Ask Neon Do to “log this decision to my work journal” — or anything that implies journal access — and it will call the Workjournal tools. You can inspect and toggle individual tools per server in the same settings panel.

Other agents — Open Agent Skill

Any agent that supports the Open Agent Skills format can use the Workjournal skill — Cursor, Copilot, Gemini CLI, and more.

Install from marketplace

If your agent has a skill marketplace, search for Workjournal and install.

Install from GitHub

Download the release zip from github.com/workjournal-pro/skill:

curl -sL https://github.com/workjournal-pro/skill/releases/latest/download/skill.zip \
  -o /tmp/workjournal-skill.zip
unzip /tmp/workjournal-skill.zip -d skills/workjournal

Authenticate

/workjournal login

The skill prints a URL — open it in any browser, click Approve, copy the 8-character code, and paste it back. Works in local terminals, SSH, dev containers, and CI.

Start journaling

/workjournal              # write a new entry
/workjournal last 3       # view recent entries
/workjournal search <q>   # search past entries

See the commands reference for the full list.

Other agents — remote MCP

If your agent supports the Model Context Protocol, point it at the Workjournal remote MCP server — no install needed.

1. Add the server

Wherever your agent configures MCP servers (connectors, integrations, or an mcpServers config block), add:

Name: Workjournal
MCP server URL: https://mcp.workjournal.pro

2. Authorize

Your agent opens the Workjournal login page (OAuth). Sign in and click Approve — the connection is active once you’re returned.

3. Use it

Ask your agent to “use workjournal to log today’s decisions”, or just ask something that implies journal access and it will call the tools. See the MCP reference for the full tool list.