Skip to content
Back to search

yourworklore-mcp

MCP server for Your Work Lore: let Claude read and write your work journal, resume bullets and interview stories

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ellisgl--yourworklore-mcp/badge.svg)](/listings/ellisgl--yourworklore-mcp)

HTML

<a href="/listings/ellisgl--yourworklore-mcp"><img src="/api/listings/ellisgl--yourworklore-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 101 lines
  1. # Your Work Lore MCP
  2. An [MCP](https://modelcontextprotocol.io) server for Your Work Lore, 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".
  3. 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.
  4. ## Connecting
  5. The server speaks MCP over HTTP at `/mcp`. Authenticate with a Worklore **personal access token**, made in the app under Settings (the API is documented at [yourworklore.com/doc](https://yourworklore.com/doc)):
  6. - `read`: the 15 read tools only. Claude can look, never change.
  7. - `read_write`: also the 15 write tools.
  8. **Claude Code:**
  9. ```sh
  10. claude mcp add --transport http worklore https://yourworklore.com/mcp \
  11. --header "Authorization: Bearer wlp_..."
  12. ```
  13. **claude.ai and the Claude apps** connect by signing in (OAuth): add a custom connector (claude.ai, **Plugins → Add → Add custom connector**; in some versions **Customize → Connectors**) with the address `https://yourworklore.com/mcp` with either OAuth client (Claude's published identity, or **Register automatically**), then sign in to Your Work Lore and allow it, read and write or read only. Claude Code can sign in the same way (`claude mcp add --transport http worklore https://yourworklore.com/mcp`, then `/mcp`). The API is the OAuth server; this server answers a request without a token with 401 and a `WWW-Authenticate` header naming the API's protected resource document (`MCP_RESOURCE_METADATA_URL`).
  14. ## Tools
  15. | Read | |
  16. |---|---|
  17. | `get_overview` | Profile, the resume's headline and summary, current positions, companies. The place to start. |
  18. | `list_work_structure` | Companies → products → projects, to find ids by name |
  19. | `list_positions` | Jobs held, for one company or all |
  20. | `list_skills` | Every tag with its category and level |
  21. | `search_journal` | Journal entries; full-text `q`, tag, dates, company, position, project, personal project |
  22. | `summarize_journal` | Counts, span, projects and skills ranked by work, for the same filters |
  23. | `get_journal_entry` | One entry in full |
  24. | `list_accomplishments` / `get_accomplishment` | Resume bullets, with notes, skills and evidence |
  25. | `list_stories` / `get_story` | STAR interview stories |
  26. | `list_resume_sections` | Personal projects, certifications or education |
  27. | `find_gaps` | What the record is missing, as questions to ask |
  28. | `get_resume` | The resume as JSON Resume |
  29. | `get_history` | Every change to one record |
  30. | Write (`read_write` tokens only) | |
  31. |---|---|
  32. | `log_work` | Write a journal entry, under a project, a position or a personal project |
  33. | `update_journal_entry` | Change one |
  34. | `save_accomplishment` | Create or change a resume bullet |
  35. | `save_story` | Create or replace a STAR story |
  36. | `save_personal_project`, `save_certification`, `save_education` | Create or replace a resume record |
  37. | `save_company`, `save_product`, `save_project` | Create or change the work structure that journal entries go under |
  38. | `save_position` | Create or change a job; end it, or make it current again |
  39. | `save_resume_summary` | Set the resume's headline and summary |
  40. | `save_profile` | Set the contact details and links at the top of the resume |
  41. | `ensure_tag` | Find a tag by name, or create it (and its category) |
  42. | `archive` | Archive or restore any record; nothing is deleted |
  43. **Prompts:** `draft_resume_bullets`, `interview_prep`, `fill_the_gaps`, `year_in_review`.
  44. ## Running
  45. Needs [Bun](https://bun.sh) 1.3+.
  46. ```sh
  47. bun install
  48. cp .env.example .env # set WORKLORE_API_URL
  49. bun run dev # restarts on changes
  50. ```
  51. | Variable | |
  52. |---|---|
  53. | `WORKLORE_API_URL` | Required. The API's base URL, as this server reaches it. |
  54. | `MCP_ALLOWED_HOSTS` | Hostnames it answers to besides localhost, e.g. `yourworklore.com`. Other `Host` headers get 403 (DNS rebinding protection). |
  55. | `MCP_ALLOWED_ORIGINS` | Browser origins (hostnames) allowed to call it. Requests without an `Origin`, which is most MCP clients, always pass. |
  56. | `PORT`, `HOST` | Where to listen (default `0.0.0.0:3000`) |
  57. | `MCP_RESOURCE_METADATA_URL` | The API's OAuth protected resource document (`https://<site>/.well-known/oauth-protected-resource/mcp`), named on a 401 so OAuth clients can sign in. Leave unset and only pasted tokens work. |
  58. | `TOKEN_CACHE_SECONDS` | How long a verified token is trusted before asking the API again (default 60) |
  59. **Docker:** `docker build -t worklore-mcp .`, then run it with `WORKLORE_API_URL` and `MCP_ALLOWED_HOSTS` set. `GET /health` answers `{"status": "ok"}`.
  60. Your Work Lore runs this server for everyone at `https://yourworklore.com/mcp`; you only need to run your own to change it.
  61. ## Development
  62. ```sh
  63. bun test # unit and HTTP tests, against a fake API
  64. bun run typecheck
  65. ```
  66. 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.
  67. ```text
  68. src/index.ts Bun.serve entry
  69. src/http.ts /mcp and /health; Host/Origin checks; bearer auth
  70. src/auth.ts Verifies a token with GET /api/me, caches the answer
  71. src/api.ts Worklore API client
  72. src/server.ts Builds the MCP server for one caller
  73. src/tools/ read.ts, write.ts, common.ts
  74. src/prompts.ts The prompts
  75. ```
  76. ## License
  77. [BSD 3-Clause](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.