Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
uv sync2
Register it in Claude Code
claude mcp add jsonresume-mcp -- uv --directory /path/to/resumejson-mcp run resumejson-mcpReplace any placeholder paths in the command with the real path on your machine.
3
Make your agent remember this setup
jsonresume-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- JSON Resume schema support with custom MCP extensions
- Full CRUD operations for work experience and career history
- Nested bullet point and major project management for positions
- Direct resource access to experience.json data
- Intelligent guidance prompts for information extraction
Tools 7
get_all_workList all work positions.get_work_by_idGet details of a specific position.add_workAdd a new work position with bullets and projects.update_workUpdate an existing position.delete_workRemove a position.add_bullet_to_workAdd a single bullet to a position.add_major_project_to_workAdd a major project to a position.Try it
→List all my work experience entries to see what is currently stored.
→Add a new work position for my role at Acme Corp as a Senior Developer.
→Add a new major project to my current role detailing the migration to FastAPI.
→Update the summary for my position at Tech Solutions to include my recent leadership achievements.
→Get the details for my project with ID project-1.
Original README from gage-russell/jsonresume-mcp
resumejson-mcp
A Model Context Protocol (MCP) server for managing JSON Resume data with MCP extensions. This server provides tools for storing and managing comprehensive career experience data that can be used to generate tailored resumes.
Features
- JSON Resume Schema: Standard resume format with custom MCP extensions
- Work Experience Management: Add, update, delete work positions with nested bullets and projects
- Experience Resource: Access your complete experience.json data via MCP
- Intelligent Guidance: Built-in prompts to help agents extract complete information
Installation
uv sync
Adding the MCP to VS Code
- Open your VS Code settings and locate the MCP servers configuration
- Add the following configuration:
{
"mcpServers": {
"resumejson-mcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/resumejson-mcp",
"run",
"resumejson-mcp"
]
}
}
}
- Replace
/path/to/resumejson-mcpwith the actual path to your cloned repository - Restart VS Code or reload the MCP servers
- The server will be available with tools for managing work experience
Usage
The MCP server provides the following tools:
get_all_work- List all work positionsget_work_by_id- Get details of a specific positionadd_work- Add a new work position with bullets and projectsupdate_work- Update an existing positiondelete_work- Remove a positionadd_bullet_to_work- Add a single bullet to a positionadd_major_project_to_work- Add a major project to a position
Resource
experience://data/experience.json- Access the complete experience data file
Data Structure
Experience data is stored in ~/.resumejson-mcp/experience/experience.json following the JSON Resume schema with MCP extensions:
{
"basics": { /* name, email, phone, location, profiles */ },
"work": [
{
"name": "Company Name",
"position": "Job Title",
"startDate": "2020-01",
"endDate": "2023-12",
"summary": "Role description",
"url": "https://company.com",
"location": "City, State",
"mcp-details": {
"id": "unique-id",
"bullets": [
{ "id": "bullet-1", "text": "Accomplishment", "tags": ["skill"] }
],
"major_projects": [
{
"id": "project-1",
"name": "Project Name",
"summary": "What you built and your role",
"technologies": ["Python", "FastAPI"],
"outcomes": "Results and metrics",
"tags": ["backend"]
}
],
"tags": ["python", "api"]
}
}
],
"education": [],
"skills": [],
"projects": []
}