mcp-me

Your AI assistants don't know who you are. Every time you start a conversation with Claude, Copilot, Cursor, or Windsurf, it's a blank slate — no context about your skills, your projects, your career, or what you care about.

mcp-me fixes that. It creates a structured personal profile that any AI assistant can read via the Model Context Protocol (MCP). Think of it as a digital identity layer for AI — your bio, career, skills, interests, projects, and more, always available to every AI tool you use.

You: "Write me a cover letter for this job"
AI:  (reads your me://career, me://skills, me://projects)
     "Based on your 5 years at Acme Corp, your TypeScript expertise,
      and your open-source work on mcp-me..."

Why mcp-me?

• AI that knows you — Your assistants remember your skills, career, projects, and personality across every conversation
• Auto-generated — Pull data from 342+ sources (GitHub, Medium, Strava, Goodreads, and hundreds more) with one command
• Privacy-first — All data stays local in YAML files on your machine. Nothing is sent to any cloud.
• Real-time plugins — 13 live integrations (Spotify now playing, GitHub repos, Last.fm scrobbles) that AI queries on demand
• Extensible — Community-driven generators and plugins. Add a new data source in ~10 lines of code.
• Works everywhere — Claude Desktop, Cursor, Windsurf, Copilot, and any MCP-compatible AI assistant

Installation

Prerequisite: Node.js 20 or later. Verify with node -v.

Recommended — install globally:

npm install -g mcp-me

This makes the mcp-me command available everywhere on your system. No need to clone any repository — npm downloads the package for you.

mcp-me --help
mcp-me init ~/my-profile
mcp-me generate ~/my-profile
mcp-me serve ~/my-profile

Alternative — run without installing (via npx):

npx mcp-me --help

npx downloads the package temporarily and runs it. Useful for trying mcp-me once, but slower on repeated use since it re-downloads each time.

Quick Start

# 1. Initialize your profile (creates YAML templates + .mcp-me.yaml config)
mcp-me init ~/my-profile

# 2. Edit the config file — uncomment your sources
code ~/my-profile/.mcp-me.yaml

Your .mcp-me.yaml config file:

generators:
  github: your-username
  devto: your-username
  bluesky: handle.bsky.social
  zodiac: aquarius

plugins:
  github:
    enabled: true
    username: your-username

# 3. Generate! Reads sources from .mcp-me.yaml automatically
mcp-me generate ~/my-profile

# 4. Start the MCP server
mcp-me serve ~/my-profile

CLI flags also work: mcp-me generate ~/my-profile --github octocat --devto myuser

All commands work with npx (zero install) or with mcp-me directly if installed globally. The generate command pulls your data from public APIs and auto-populates profile YAML files — no API keys needed for most sources.

Profile directory structure

my-profile/
  .mcp-me.yaml        ← Configuration (generators + plugins)
  identity.yaml        ← Your data (name, bio, contact)
  skills.yaml          ← Your data (languages, tools)
  projects.yaml        ← Your data (portfolio)
  career.yaml          ← Your data (experience)
  interests.yaml       ← Your data (hobbies, topics)
  personality.yaml     ← Your data (traits, values)
  goals.yaml           ← Your data (short/long-term)
  faq.yaml             ← Your data (Q&A pairs)

Configure Your AI Assistant

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "me": {
      "command": "npx",
      "args": ["mcp-me", "serve", "/absolute/path/to/my-profile"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "me": {
      "command": "npx",
      "args": ["mcp-me", "serve", "/absolute/path/to/my-profile"]
    }
  }
}

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "me": {
      "command": "npx",
      "args": ["mcp-me", "serve", "/absolute/path/to/my-profile"]
    }
  }
}

Profile Schema

Your profile is a collection of YAML files:

File	Description
identity.yaml	Name, bio, location, languages, contact info
career.yaml	Work experience, education, certifications
skills.yaml	Technical and soft skills with proficiency levels
interests.yaml	Hobbies, music, books, movies, food preferences
personality.yaml	Values, traits, MBTI, strengths
goals.yaml	Short, medium, and long-term goals
projects.yaml	Personal and open-source projects
faq.yaml	Custom Q&A pairs about yourself

See Schema Reference for full documentation.

MCP Interface

Resources

Static profile data exposed as MCP resources:

• me://identity — Personal identity and contact
• me://career — Professional history
• me://skills — Skills and proficiencies
• me://interests — Hobbies and preferences
• me://personality — Personality traits and values
• me://goals — Personal and professional goals
• me://projects — Portfolio and projects
• me://faq — Frequently asked questions

Tools

• ask_about_me — Free-form question about the user
• search_profile — Keyword search across all profile data

Prompts

• introduce_me — Generate a 2-paragraph introduction
• summarize_career — Summarize career trajectory
• technical_profile — Describe technical skills and stack
• collaboration_fit — Evaluate fit for a project

Generators (42 data sources)

Generators run during mcp-me generate to auto-populate your profile from public APIs. No API keys needed for most sources.

Category	Flag	Source	Data
Code	--github <user>	GitHub API	Repos, languages, stars, profile
Code	--gitlab <user>	GitLab API	Projects, topics, profile
Code	--bitbucket <user>	Bitbucket API	Repos, languages
Code	--huggingface <user>	Hugging Face API	Models, datasets, spaces
Code	--kaggle <user>	Kaggle API	Competitions, datasets, medals
Code	--codeberg <user>	Gitea API	Repos, languages
Writing	--devto <user>	DEV.to API	Articles, tags, reactions
Writing	--medium <user>	Medium RSS	Articles, categories
Writing	--hashnode <user>	Hashnode GraphQL	Blog posts, tags
Writing	--substack <user>	Substack RSS	Newsletter posts
Writing	--wordpress <site>	WordPress API	Blog posts, categories, tags
Writing	--openlibrary <user>	Open Library API	Books authored
Writing	--orcid <id>	ORCID API	Academic publications
Writing	--semanticscholar <id>	S2 API	Research papers, citations
Writing	--youtube <channel>	YouTube RSS	Videos, channel info
Community	--stackoverflow <id>	Stack Exchange API	Top tags, reputation, badges
Community	--hackernews <user>	HN Firebase API	Karma, submissions
Community	--mastodon <user@host>	Mastodon API	Posts, hashtags, bio
Community	--bluesky <handle>	AT Protocol API	Posts, followers
Community	--reddit <user>	Reddit JSON API	Karma, bio
Community	--producthunt <user>	ProductHunt GraphQL	Launched products, upvotes
Community	--threads <user>	Threads API	Bio, follower stats
Packages	--npm <user>	npm Registry	Published packages
Packages	--pypi <pkgs>	PyPI JSON API	Package metadata
Packages	--crates <user>	Crates.io API	Rust crates
Packages	--dockerhub <user>	Docker Hub API	Container images
Activity	--wakatime <user>	WakaTime API	Coding time, languages, editors
Activity	--letterboxd <user>	Letterboxd RSS	Films watched, ratings
Activity	--goodreads <user>	Goodreads RSS	Books, reading list
Activity	--chess <user>	Chess.com API	Rating, stats
Activity	--lichess <user>	Lichess API	Rating, games
Activity	--codewars <user>	Codewars API	Rank, honor, languages
Activity	--leetcode <user>	LeetCode GraphQL	Problems solved, contests
Activity	--lastfm <user>	Last.fm API	Listening history, top artists
Activity	--steam <id>	Steam API	Games, playtime
Activity	--twitch <user>	Twitch API	Stream info
Activity	--dribbble <user>	Dribbble	Design shots, portfolio
Activity	--unsplash <user>	Unsplash API	Photos, downloads, collections
Activity	--exercism <user>	Exercism API	Language tracks, exercises
Activity	--hackerrank <user>	HackerRank API	Badges, challenges solved
Activity	--anilist <user>	AniList GraphQL	Anime/manga stats, genres
Identity	--gravatar <email>	Gravatar API	Bio, linked accounts, photo
Identity	--keybase <user>	Keybase API	Verified identity proofs

Want to add a new data source? See the Generator Creation Guide.

Plugins (13 live integrations)

Plugins run during mcp-me serve and provide real-time data to AI assistants on every query.

Plugin	Description	Auth
GitHub	Live repos, activity, languages	Optional token
Spotify	Now playing, top artists, playlists	OAuth required
LinkedIn	Professional history from export	Local JSON file
WakaTime	Live coding stats, languages	Optional API key
DEV.to	Live articles, reactions	Optional API key
Bluesky	Live posts, profile, followers	None
Hacker News	Live stories, karma	None
Reddit	Live karma, posts	None
GitLab	Live projects, activity, MRs	Optional token
Mastodon	Live toots, profile, engagement	None
YouTube	Live videos, channel stats	Optional API key
Last.fm	Now playing, top artists, scrobbles	Optional API key
Steam	Currently playing, game library	Optional API key

Enable plugins in .mcp-me.yaml:

plugins:
  github:
    enabled: true
    username: "your-username"
  spotify:
    enabled: true
    client_id_env: "SPOTIFY_CLIENT_ID"
    client_secret_env: "SPOTIFY_CLIENT_SECRET"
    refresh_token_env: "SPOTIFY_REFRESH_TOKEN"

Community plugins are installed from npm (mcp-me-plugin-*) and auto-discovered. See the Plugin Creation Guide.

Generators vs Plugins

	Generators	Plugins
Run when	mcp-me generate (once)	mcp-me serve (continuously)
Output	Static YAML files	Live MCP resources/tools
Auth	Almost never needed	Sometimes (OAuth)
Example	"Repos I had in March"	"Repos I have right now"
Extend	Add src/generators/*.ts	Add src/plugins/*/

CLI Reference

# Auto-generate profile from multiple data sources
mcp-me generate <dir> --github <user> [--devto <user>] [--stackoverflow <id>] ...

# Initialize with blank YAML templates
mcp-me init <directory>

# Validate profile YAML files
mcp-me validate <directory>

# Start the MCP server
mcp-me serve <directory>

# Scaffold a new generator or plugin (for contributors)
mcp-me create generator <name> [--category <category>]
mcp-me create plugin <name>

Development

# Clone the repo
git clone https://github.com/paladini/mcp-me.git
cd mcp-me

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Run in dev mode
npm run dev

FAQ

What is MCP (Model Context Protocol)? MCP is an open standard by Anthropic that connects AI assistants to external data sources. mcp-me uses MCP to let AI assistants read your personal profile data.

Do I need API keys? Most generators use public APIs with no auth needed. Some (Strava, Spotify) require tokens — see the .mcp-me.yaml comments for details.

Can I use this with Claude Desktop / Cursor / Windsurf? Yes! Any MCP-compatible AI assistant works. See the Configure Your AI Assistant section.

How do I add a new data source? Run mcp-me create generator myservice to scaffold a new generator, or see the Generator Creation Guide.

Is my data stored anywhere? No. All data stays local in your YAML files. The MCP server reads from disk — nothing is sent to any cloud.

How many generators are there? 342+ generators across 24 categories — from GitHub and Medium to Zodiac signs and D&D alignment.

Contributing

We welcome contributions! Whether it's a new plugin, a bug fix, or documentation improvements — see CONTRIBUTING.md for guidelines.

License

MIT