Basic Memory
Rank #68io.github.basicmachines-co/basic-memory
Local-first knowledge management with bi-directional LLM sync via Markdown files.
What you can do with Basic Memory
Basic Memory is a Model Context Protocol (MCP) server published by basicmachines-co. It ranks #68 of 144,396 active servers on MCP Toplist, and its repository has 4,165 GitHub stars. Basic Memory is listed across 4 registries — Official MCP, PulseMCP, mcp.so and Glama, with 10 tracked versions. It was first listed on Mar 11, 2025 and most recently updated on Aug 25, 2026.
Not verifiedMCP Toplist has not yet written a checked profile for this server, so the paragraph above is assembled from registry data only. The repository README is the authority on what it does.
What Basic Memory can and cannot do
Not verifiedMCP Toplist has not catalogued this server's tools or limitations. The repository README lists them.
What you need before using Basic Memory
The registry listing declares no required environment variables or authentication. This is declared metadata, not a verified install — the repository README is the authority.
Declared by Glama, last synced Oct 16, 2026. Not independently verified by MCP Toplist.
No runtime, credential or payment requirements are recorded for this server beyond the declaration above.
Connect Basic Memory and confirm it works
claude mcp add basic-memory -- uvx basic-memory mcp basic-memory[mcp_servers.basic-memory]
command = "uvx"
args = ["basic-memory", "mcp", "basic-memory"]Add to ~/.codex/config.toml.
{
"mcpServers": {
"basic-memory": {
"command": "uvx",
"args": [
"basic-memory",
"mcp",
"basic-memory"
]
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config).
{
"mcpServers": {
"basic-memory": {
"command": "uvx",
"args": [
"basic-memory",
"mcp",
"basic-memory"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project).
{
"servers": {
"basic-memory": {
"type": "stdio",
"command": "uvx",
"args": [
"basic-memory",
"mcp",
"basic-memory"
]
}
}
}Save as .vscode/mcp.json in your workspace.
{
"mcpServers": {
"basic-memory": {
"command": "uvx",
"args": [
"basic-memory",
"mcp",
"basic-memory"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
{
"mcpServers": {
"basic-memory": {
"command": "uvx",
"args": [
"basic-memory",
"mcp",
"basic-memory"
]
}
}
}After adding the config, ask your client to list this server's tools. A tool list confirms the connection; an empty list or an error means the server did not start or needs credentials.
When to choose another server
No task-specific alternatives are catalogued for Basic Memoryyet; the list above is its publisher's other servers.
What changed, and when this was checked
- First listed
- Mar 11, 2025
- Latest version published
- Aug 25, 2026
- Version history
- 10 versions tracked (below)
- Requirements evidence
- Declared by Glama, last synced Oct 16, 2026. Not independently verified by MCP Toplist.
- Profile checked
- Not yet — purpose, capabilities and requirements above come from registry data only
- Ranking data as of
- Oct 16, 2026
- Official MCP ↗listed since Apr 25, 2026 · still listed
- PulseMCP ↗listed since Jun 4, 2026 · still listed
- mcp.so ↗listed since Jun 4, 2026 · still listed
- Glama ↗listed since Jun 4, 2026 · still listed
Do you maintain Basic Memory? to correct or enrich this profile.
Available versions (10)
| Version | Published |
|---|---|
| 0.23.2 | Aug 25, 2026 |
| 0.23.1 | Aug 25, 2026 |
| 0.23.0 | Aug 24, 2026 |
| 0.22.1 | Jun 13, 2026 |
| 0.21.5 | May 26, 2026 |
| 0.20.2 | Mar 11, 2026 |
| 0.20.1 | Mar 11, 2026 |
| 0.20.0 | Mar 11, 2026 |
| 0.17.7 | Jan 19, 2026 |
| 0.1.0 | Nov 25, 2024 |
Ranks ahead of 144,328 of 144,396 servers on MCP Toplist.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.basicmachines-co%2Fbasic-memory)<a href="https://mcptoplist.com/server/io.github.basicmachines-co%2Fbasic-memory"><img src="https://mcptoplist.com/badge/io.github.basicmachines-co%2Fbasic-memory.svg" alt="MCP Toplist: Top 1% of 144,396" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Frequently asked questions
- Who maintains Basic Memory?
- Basic Memory is maintained by basicmachines-co, which publishes 3 MCP servers (10 total versions) tracked on MCP Toplist.
- Is Basic Memory listed on the Official MCP Registry?
- Yes — Basic Memory is listed on the Official MCP Registry, alongside PulseMCP, mcp.so and Glama.
- How many versions does Basic Memory have?
- MCP Toplist tracks 10 versions of Basic Memory, most recently published on Aug 25, 2026.
- Where can I find the source code for Basic Memory?
- The source code for Basic Memory is hosted at github.com/basicmachines-co/basic-memory.git.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.