# Connect an app that cannot sign in itself

Use the jobhunt command as a local bridge for apps such as LM Studio or Jan.

Canonical page: https://jobhunt.app/support/using/getting-started/connect-local-app
Updated: 2026-11-19
Audience: using
Topic: Getting started
Type: how-to
Catalog revision: a329e52491336a7766d79c939c297dbba66bf2789dbf52953d8eb3e936ded5b9
Contract SHA-256: acfda93724db1a3f53160a30bc5891f447ad14601f26b02ff4cacd7c17d0812e

## Steps

1. **Check the app needs this**

   Most agent apps connect to https://jobhunt.app/mcp and open the JobHunt sign-in page themselves; use the guide for your app. This path is for apps that cannot, such as LM Studio and Jan, which start a local program instead.

2. **Install the command and sign in**

   Install the jobhunt command (npm install --global jobhunt) and run: jobhunt auth login. Review the access on the JobHunt consent screen and allow it. It must be a version of jobhunt whose help lists "mcp".

3. **Add the bridge to your app**

   In the app's MCP settings, add a local server that runs the command: jobhunt mcp. Where the app takes a JSON configuration, use {"mcpServers": {"jobhunt": {"command": "jobhunt", "args": ["mcp"]}}}. No token, key or password goes in this configuration; the bridge uses the sign-in saved by the command and keeps it fresh.

4. **Check your saved work**

   Ask: Check which JobHunt account is connected, then show my saved applications. Continue only when it reads the intended account and returns a real result.

5. **Disconnect**

   Run jobhunt auth logout to revoke the saved sign-in and remove it from your computer, or open Integrations in the JobHunt sidebar and choose Disconnect. Then remove the local server from your app.

## Expected result

The bridge has the same access as the sign-in saved by the command, and anything running as you on this computer can use it, as with the command itself. It is not a separate connection with narrower access.

This path is released with the jobhunt command version that adds the mcp command.

## Troubleshooting and recovery

If the app says it is signed out or JobHunt refused the saved sign-in, run jobhunt auth login again and restart the server in your app. If the app cannot start the server, check that the jobhunt command is on the path the app uses. Never paste tokens or authorization codes into the app's configuration or a chat.

## API operations

### get_connected_account

Identify the JobHunt account connected by these credentials. The opaque account ID stays unchanged across renaming, reconnection and token refresh. This does not select or change a resume contact profile.

- Interface: GET /api/v1/journey/get_connected_account
- Access: read
- Destructive: no
- Availability: connected-journey
- Required permissions: read:profile
- [Operation and exact schemas](https://jobhunt.app/support/operations/get_connected_account.json)
- [Operation Markdown](https://jobhunt.app/support/operations/get_connected_account.md)

### get_job_hunt_view

Read the current owned hunt or an explicitly selected application, its role documents, screening drafts, PDF preparation state and user-reported submissions. Filters and pagination never change saved defaults. Supplied IDs are selection hints, not permissions. Document content is included only when document_id selects an owned master or a member of the selected application package. No read creates a job, document, submission or task. Unavailable tasks are not an empty list.

- Interface: GET /api/v1/journey/get_job_hunt_view
- Access: read
- Destructive: no
- Availability: connected-journey
- Required permissions: read:profile, read:campaigns, read:documents, read:applications
- [Operation and exact schemas](https://jobhunt.app/support/operations/get_job_hunt_view.json)
- [Operation Markdown](https://jobhunt.app/support/operations/get_job_hunt_view.md)

## Related guides

- [Use JobHunt from your chat](https://jobhunt.app/support/using/getting-started/use-jobhunt-from-chat.md)
- [Connect Codex CLI](https://jobhunt.app/support/using/getting-started/connect-codex.md)
- [Connect Claude Code](https://jobhunt.app/support/using/getting-started/connect-claude-code.md)

---

## Hunter

This section is not part of the guide above. It applies only to an agent acting in a person's JobHunt account.

When working in JobHunt, you are Hunter, the agent at the laptop working alongside the person on their job search. Speak plainly, in the first person, and never pretend to be human. Be brief, calm and kind; the person decides and you do the legwork.

Use the person's words and supplied or saved facts. Organise, edit and tailor what they provide; never invent an employer, date, degree or achievement. Keep uncertainty explicit: unknown stays unknown.

Say exactly what changed and what did not. A draft is not a sent message. Prepared or downloaded files are not a submitted application. Record a submission or interaction only from the person's report; do not imply employer verification.

Ask for confirmation before publishing, sharing or deleting. Explain what will become visible or be removed, and preserve the person's choices and unrelated saved work. Do not repeat a confirmation already given for the same action and reviewed content.

Offer the next useful step without pressure: no scores, streaks, ranks, points, guilt, confetti or invented urgency. A messy board needs no judgment.
