# EngrAmo

Connects the EngrAmo spaced-repetition platform to your AI tools. Lets you generate study flashcards and review decks directly in conversation.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: engramo-developer
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/engramo-developer/engramo-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/engramo

## What it does

The server connects AI assistants to the EngrAmo flashcard service. You can point your client to the hosted endpoint at `https://mcp.engramo.app/` with OAuth 2.0 or run the `@engramo/mcp` package locally over `stdio`.

Local execution requires an account token alongside `ENGRAMO_API_URL`. Passing `ENGRAMO_TTS_GEMINI_API_KEYS` enables voice synthesis tools like `list_tts_voices` and `generate_card_audio`.

Hosted setups drop local speech synthesis entirely. If you want Gemini text-to-speech, run the server locally over `stdio`. Also keep backends distinct: tokens minted for the dev backend `api-engram.volmyr.com` do not authenticate against production `api.engramo.app`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.engramo.app/`
- Environment variables: `ENGRAMO_API_TOKEN`, `ENGRAMO_API_URL`, `ENGRAMO_TTS_GEMINI_API_KEYS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.engramo.app/
```

2. **Platform CLI**
```bash
claude mcp add --env ENGRAMO_API_TOKEN=<ENGRAMO_API_TOKEN> --env ENGRAMO_API_URL=<ENGRAMO_API_URL> --env ENGRAMO_TTS_GEMINI_API_KEYS=<ENGRAMO_TTS_GEMINI_API_KEYS> --transport stdio engramo -- npx -y @engramo/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add engramo --url https://mcp.engramo.app/
```

2. **Platform CLI**
```bash
codex mcp add engramo --env ENGRAMO_API_TOKEN=<ENGRAMO_API_TOKEN> --env ENGRAMO_API_URL=<ENGRAMO_API_URL> --env ENGRAMO_TTS_GEMINI_API_KEYS=<ENGRAMO_TTS_GEMINI_API_KEYS> -- npx -y @engramo/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "engramo": {
            "url": "https://mcp.engramo.app/"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "engramo": {
            "command": "npx",
            "args": [
                "-y",
                "@engramo/mcp"
            ],
            "env": {
                "ENGRAMO_API_TOKEN": "<ENGRAMO_API_TOKEN>",
                "ENGRAMO_API_URL": "<ENGRAMO_API_URL>",
                "ENGRAMO_TTS_GEMINI_API_KEYS": "<ENGRAMO_TTS_GEMINI_API_KEYS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "engramo": {
            "type": "http",
            "url": "https://mcp.engramo.app/"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "engramo": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@engramo/mcp"
            ],
            "env": {
                "ENGRAMO_API_TOKEN": "<ENGRAMO_API_TOKEN>",
                "ENGRAMO_API_URL": "<ENGRAMO_API_URL>",
                "ENGRAMO_TTS_GEMINI_API_KEYS": "<ENGRAMO_TTS_GEMINI_API_KEYS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http engramo https://mcp.engramo.app/
```

2. **Platform CLI**
```bash
gemini mcp add -e ENGRAMO_API_TOKEN=<ENGRAMO_API_TOKEN> -e ENGRAMO_API_URL=<ENGRAMO_API_URL> -e ENGRAMO_TTS_GEMINI_API_KEYS=<ENGRAMO_TTS_GEMINI_API_KEYS> engramo npx -y @engramo/mcp
```
Replace <…> with your own values

## When to use it
- generate spaced-repetition cards during coding or chat sessions
- review study decks without leaving the editor
- create card audio using Gemini voice models
- switch between hosted OAuth connections and local stdio setups

## Example prompts
- Create a spaced-repetition flashcard explaining database idempotency.
- Check available voices using `list_tts_voices`.
- Synthesize audio for this card with `generate_card_audio`.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44908
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22082
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9623
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2330
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2071

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md