342+
Generators
13
Live Plugins
24
Categories
8
Profile Schemas
0
Cloud Dependencies
The Problem

Your AI has no idea who you are

Every answer is generic. Every suggestion is impersonal. Because no AI assistant has any context about you.

You: Help me write a cover letter → Gets a template with [Your Name] and [Your Skills]
You: Suggest a side project → Gets "try building a to-do app"
You: Review my architecture → Gets advice for a stack you don't use
You: Help me prepare for an interview → Gets generic STAR method tips
You: Recommend books for me → Gets the same list everyone gets
Generic answers because the AI knows nothing about your skills, career, or interests.
With mcp-me
Help me write a cover letter
Based on your 5 years at Acme Corp, your TypeScript expertise, and your open-source work on me://projects — here's a tailored cover letter…

Same prompt. Personalized answer. Because the AI already knows you.

Features

Built for developers who use AI daily

A personal identity layer that's private, extensible, and works with every major AI assistant.

Privacy-First
All data stays in local YAML files on your machine. Nothing is sent to any cloud. You own your data — always.
342+ Auto-Generators
Pull data from GitHub, Medium, Strava, Goodreads, and hundreds more with a single command. No API keys needed for most.
13 Live Plugins
Real-time integrations — Spotify now playing, GitHub repos, Last.fm scrobbles — queried on demand by your AI.
Works Everywhere
Claude Desktop, Cursor, Windsurf, Copilot — any MCP-compatible AI assistant reads your profile natively.
Fully Extensible
Community-driven generators and plugins. Add a new data source in ~10 lines of code. npm ecosystem support built-in.
Config-Driven
A single .mcp-me.yaml dotfile separates configuration from profile data. Clean, versioned, portable.
How It Works

Four simple steps

Go from zero to a fully personalized AI experience in just a few minutes.

1
Initialize
Create your profile directory with YAML templates and a config file.
$ mcp-me init ~/my-profile
2
Configure
Open .mcp-me.yaml and tell it where to find your data — your GitHub username, DEV.to handle, etc.
$ code ~/my-profile/.mcp-me.yaml
3
Generate
Pull data from 342+ public APIs automatically based on your config.
$ mcp-me generate ~/my-profile
4
Serve
Start the MCP server. Every AI assistant can now read your profile.
$ mcp-me serve ~/my-profile
Generators

342+ data sources, one command

Auto-populate your profile from public APIs. No API keys needed for most sources. Run mcp-me generate and watch the magic happen.

💻
Code
GitHub, GitLab, Bitbucket, +3
✍️
Writing
DEV.to, Medium, Hashnode, +7
💬
Community
Stack Overflow, Reddit, +5
📦
Packages
npm, PyPI, Crates, Docker
⚡
Activity
WakaTime, Letterboxd, +8
🎮
Gaming
Chess, Lichess, Steam
🎵
Music
Last.fm, Spotify
🎨
Creative
Dribbble, Unsplash
🏃
Fitness
Strava, Exercism
📚
Learning
LeetCode, Codewars, +3
🔬
Science
ORCID, Semantic Scholar
🪪
Identity
Gravatar, Keybase
24 categories · 342+ generators · Create your own →
Live Plugins

Real-time data, on every query

Plugins run during mcp-me serve and provide live data to AI assistants. Your AI always has up-to-date context.

GitHub
Live repos, activity, languages, and contribution stats
Optional token
Spotify
Now playing, top artists, playlists, and listening history
OAuth required
LinkedIn
Professional history parsed from JSON data export
Local file
WakaTime
Live coding stats, languages, editors, and daily activity
Optional API key
DEV.to
Live articles, reactions, comments, and follower count
Optional API key
Bluesky
Live posts, profile info, and follower stats
No auth
Hacker News
Live stories, karma, and submission history
No auth
Reddit
Live karma, posts, and comment activity
No auth
GitLab
Live projects, activity, and merge requests
Optional token
Mastodon
Live toots, profile info, and engagement stats
No auth
YouTube
Live videos, channel stats, and subscriber count
Optional API key
Last.fm
Now playing, top artists, recent scrobbles
Optional API key
Steam
Currently playing, game library, and playtime stats
Optional API key
Compatibility

Works with every major AI assistant

Any tool that speaks the Model Context Protocol can read your mcp-me profile. Set up once, use everywhere.

🟤
Claude Desktop
+
🟢
Cursor
+
🔵
Windsurf
+
⚫
Copilot

…and any future MCP-compatible assistant.

Quick Start

Up and running in a few minutes

Four steps to give every AI assistant full context about who you are.

~/my-profile — bash
# 1. Install globally (or use npx)
$ npm install -g mcp-me
 
# 2. Create your profile with YAML templates
$ mcp-me init ~/my-profile
 
# 3. Edit the config — add your usernames and data sources
$ code ~/my-profile/.mcp-me.yaml
 
# 4. Auto-populate from your online presence
$ mcp-me generate ~/my-profile
 
# 5. Start the MCP server
$ mcp-me serve ~/my-profile
✓ MCP server running — AI assistants can now read your profile
Profile Schema

8 structured YAML categories

Your profile is organized into well-defined schemas. Each maps to an MCP resource that AI assistants can query.

🪪 identity.yaml
Name, bio, location, languages, contact info → me://identity
💼 career.yaml
Work experience, education, certifications → me://career
🛠️ skills.yaml
Technical and soft skills with proficiency → me://skills
🎯 interests.yaml
Hobbies, music, books, movies, food → me://interests
🧠 personality.yaml
Values, traits, MBTI, strengths → me://personality
🎯 goals.yaml
Short, medium, and long-term goals → me://goals
🚀 projects.yaml
Personal and open-source projects → me://projects
❓ faq.yaml
Custom Q&A pairs about yourself → me://faq
FAQ

Frequently asked questions

What is MCP (Model Context Protocol)?
MCP is an open standard by Anthropic that connects AI assistants to external data sources and tools. mcp-me uses MCP to let AI assistants read your personal profile data — no custom integrations needed.
Do I need API keys?
Most generators use public APIs with no auth needed. Some sources like Spotify and Strava require OAuth tokens — the config file has instructions for each.
Is my data stored anywhere in the cloud?
No. All data stays local in your YAML files on your machine. The MCP server reads from disk when queried — nothing is ever sent to any external service.
Which AI assistants are supported?
Claude Desktop, Cursor, Windsurf, GitHub Copilot, and any other AI assistant that supports the Model Context Protocol. Set up once, use everywhere.
How do I add a new data source?
Run mcp-me create generator myservice to scaffold a new generator. Most generators are under 20 lines of code. See the Generator Creation Guide for details.
Can I use this without installing globally?
Yes! Use npx mcp-me to run any command without installing. It downloads the package temporarily each time. For repeated use, global install is faster.
What's the difference between generators and plugins?
Generators run once during mcp-me generate and produce static YAML files (e.g., "repos I had in March"). Plugins run continuously during mcp-me serve and provide live data on every query (e.g., "repos I have right now").

Ready to give your AI some context?

Set up your personal profile in under a minute. Open source, privacy-first, works everywhere.

Star on GitHub View on npm