# Promise

Promise gives agents a place to look up commitments, pending replies, and saved context. Connect it when follow-up details need to carry across conversations.

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

## What it does

The server exposes tools for checking commitments and their evidence, searching stored context, saving notes, and preparing follow-up actions. Agents can also fetch a daily view or details about a person. Data access goes through the Promise platform API.

Protected tools require authorization. Without a bearer token, the server returns an authorization request; after approval, the agent exchanges a one-time code for a scoped token. `mark_resolved` and `draft_follow_up` send the user to Promise to review the action. They do not send or change email directly. The MCP server leaves platform rules and data handling to the Promise platform rather than connecting to its databases or queues itself.

## Requirements
- Remote server: `https://mcp.usepromise.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http promise https://mcp.usepromise.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add promise --url https://mcp.usepromise.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "promise": {
            "url": "https://mcp.usepromise.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "promise": {
            "type": "http",
            "url": "https://mcp.usepromise.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http promise https://mcp.usepromise.ai/mcp
```

## When to use it
- find commitments that still need attention
- check the evidence linked to a commitment
- retrieve context about a person
- save a note for a later conversation
- prepare a follow-up action for review in Promise

## Example prompts
- Show my commitments for today and the evidence attached to them.
- Find the saved context about this person and keep this note for a later conversation.
- Prepare a follow-up for this commitment so I can review it in Promise.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 397855
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 34011
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89674
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81191
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74577
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 90077

---
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