Skip to main content
Glama

Worklore MCP

An MCP server for Worklore, the work journal for resumes and interviews. It lets Claude (or any MCP client) read and write your journal, resume bullets and interview stories: "what did I do at Acme in 2024?", "draft bullets for my last job", "log what I did today".

It's a client of the Worklore API: every tool call is an API call made with your token, so it can see and do exactly what that token can.

Connecting

The server speaks MCP over HTTP at /mcp. Authenticate with a Worklore personal access token (see API.md):

  • read: the 15 read tools only. Claude can look, never change.

  • read_write: also the 9 write tools.

Claude Code:

claude mcp add --transport http worklore https://worklore-mcp.example.com/mcp \
  --header "Authorization: Bearer wlp_..."

claude.ai and the Claude apps need OAuth, which is planned (phase 2).

Related MCP server: jobhunt-copilot

Tools

Read

get_overview

Profile, current positions, companies. The place to start.

list_work_structure

Companies → products → projects, to find ids by name

list_positions

Jobs held, for one company or all

list_skills

Every tag with its category and level

search_journal

Journal entries; full-text q, tag, dates, company, position, project

summarize_journal

Counts, span, projects and skills ranked by work, for the same filters

get_journal_entry

One entry in full

list_accomplishments / get_accomplishment

Resume bullets, with notes, skills and evidence

list_stories / get_story

STAR interview stories

list_resume_sections

Personal projects, certifications or education

find_gaps

What the record is missing, as questions to ask

get_resume

The resume as JSON Resume

get_history

Every change to one record

Write (read_write tokens only)

log_work

Write a journal entry

update_journal_entry

Change one

save_accomplishment

Create or change a resume bullet

save_story

Create or replace a STAR story

save_personal_project, save_certification, save_education

Create or replace a resume record

ensure_tag

Find a tag by name, or create it (and its category)

archive

Archive or restore any record; nothing is deleted

Prompts: draft_resume_bullets, interview_prep, fill_the_gaps, year_in_review.

Running

Needs Bun 1.3+.

bun install
cp .env.example .env    # set WORKLORE_API_URL
bun run dev             # restarts on changes

Variable

WORKLORE_API_URL

Required. The API's base URL, as this server reaches it.

MCP_ALLOWED_HOSTS

Hostnames it answers to besides localhost, e.g. worklore-mcp.example.com. Other Host headers get 403 (DNS rebinding protection).

MCP_ALLOWED_ORIGINS

Browser origins (hostnames) allowed to call it. Requests without an Origin, which is most MCP clients, always pass.

PORT, HOST

Where to listen (default 0.0.0.0:3000)

TOKEN_CACHE_SECONDS

How long a verified token is trusted before asking the API again (default 60)

Docker: docker build -t worklore-mcp ., then run it with WORKLORE_API_URL and MCP_ALLOWED_HOSTS set. GET /health answers {"status": "ok"}.

Development

bun test            # unit and HTTP tests, against a fake API
bun run typecheck

Built on the MCP TypeScript SDK v2 (@modelcontextprotocol/server). The server is stateless: each request gets a fresh server instance, built for the caller's token (src/server.ts), so a read-only token never even sees the write tools.

src/index.ts      Bun.serve entry
src/http.ts       /mcp and /health; Host/Origin checks; bearer auth
src/auth.ts       Verifies a token with GET /api/me, caches the answer
src/api.ts        Worklore API client
src/server.ts     Builds the MCP server for one caller
src/tools/        read.ts, write.ts, common.ts
src/prompts.ts    The prompts

License

BSD 3-Clause, like Worklore.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables Claude conversations to perform real GitHub operations — managing issues, comments, sub-issue hierarchies, blocked_by dependencies, and Projects v2 board status — while keeping the GitHub PAT server-side and gated behind revocable bearer-token auth with an audit trail.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP clients such as Claude Desktop or compatible editors to run local, privacy-first job-search workflows including resume generation and STAR polishing, JD matching, GitHub project recommendations, mock interviews, and application tracking. It exposes these capabilities as callable tools through the Model Context Protocol.
      7
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents and their human owners to browse, search (keyword, semantic, and hybrid), create, and revise a versioned personal knowledge base of Markdown documents, checkpoint summaries, and structured tasks. Access is OAuth-protected with separately grantable read and write scopes, and edits are history-tracked with conflict protection so concurrent clients don't overwrite each other.
      5
      MIT