# mcp

Wires an AI assistant into a Nestr workspace: tasks, projects, roles, circles and discussions. Useful when a team runs on Holacracy or Sociocracy.

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

## What it does

The server exposes Nestr to an assistant over Model Context Protocol. Its tools cover search across tasks, projects and roles, creating and editing nests, comments, org structure, tensions and workspace metrics. A separate personal group — inbox, daily plan, personal labels — only works with OAuth.

Two ways to run it. Remote: `claude mcp add --transport http nestr-dev-mcp https://mcp.nestr.io/mcp`, then `/mcp` and the Authenticate button. Local: `npx -y @nestr/mcp` with `NESTR_API_KEY` set in the environment. The key comes from the workspace settings in Nestr, under integrations.

One catch: adding a member through the API needs a verified domain, while inviting someone from the app does not. Without a verified domain the provisioning tool fails, and people have to be invited by hand.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.nestr.io/mcp`

## Install

### Claude Code (native platform)

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

2. **Platform CLI**
```bash
claude mcp add nestr-dev-mcp -- npx -y @nestr/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add nestr-dev-mcp --url https://mcp.nestr.io/mcp
```

2. **Platform CLI**
```bash
codex mcp add nestr-dev-mcp -- npx -y @nestr/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nestr-dev-mcp": {
            "url": "https://mcp.nestr.io/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nestr-dev-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@nestr/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "nestr-dev-mcp": {
            "type": "http",
            "url": "https://mcp.nestr.io/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "nestr-dev-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@nestr/mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http nestr-dev-mcp https://mcp.nestr.io/mcp
```

2. **Platform CLI**
```bash
gemini mcp add nestr-dev-mcp npx -y @nestr/mcp
```

## When to use it
- pull up tasks and projects by keyword from the chat
- create a nest and place it under a circle
- check who owns customer support
- log a tension and build out its proposal parts
- read workspace metrics over a period

## Example prompts
- Which workspaces can I access?
- Search for tasks related to marketing
- Create a project called Q1 Planning and add a comment

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12109
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2760
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1348
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

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