npm package: @inkami/mcp
Description: MCP server for interacting with inkami workspaces
Latest version: 0.1.1

# @inkami/mcp

MCP server for [inkami](https://inkami.app) — the workspace for thinking, writing, and getting things done.

Connect your AI assistant to your inkami workspace. Search documents, manage tasks, read and edit content, track your agenda, and journal — all through natural conversation.

## Quick Start

```bash
npx @inkami/mcp login
```

This opens your browser to authenticate with inkami. Once logged in, your credentials are saved locally.

### Add to Claude Code

```json
// ~/.claude/settings.json
{
  "mcpServers": {
    "inkami": {
      "command": "npx",
      "args": ["@inkami/mcp"]
    }
  }
}
```

### Add to Claude Desktop

```json
// claude_desktop_config.json
{
  "mcpServers": {
    "inkami": {
      "command": "npx",
      "args": ["@inkami/mcp"]
    }
  }
}
```

Restart Claude and your workspace is ready.

## What You Can Do

**"What's on my agenda this week?"** — View upcoming tasks, deadlines, and scheduled items across your workspace.

**"Search my notes for the API migration plan"** — Full-text search across all documents with highlighted snippets.

**"Create a new project plan for the Q3 launch"** — Create documents and populate them with structured content — headings, tasks, checklists, tables.

**"Show me today's journal"** — Open or create daily journal entries.

**"What tasks are overdue?"** — Filter tasks by status, date range, or document.

**"Read the Design System document and add a section on color tokens"** — Read and edit documents using block-level operations.

**"Find pages that aren't linked to anything"** — Discover orphaned documents and strengthen your knowledge graph.

## Tools

### Documents
| Tool | Description |
|------|-------------|
| `read_document` | Read a document's full content as structured blocks |
| `edit_document` | Add, remove, move, or modify blocks in a document |
| `create_document` | Create a new document with a title |
| `create_folder` | Create a new folder |
| `rename_node` | Rename a document or folder |
| `move_node` | Move a document or folder to a new parent |
| `delete_node` | Soft-delete a document or folder |

### Search & Navigation
| Tool | Description |
|------|-------------|
| `search` | Full-text search across the workspace |
| `list_tree` | List the workspace file/folder hierarchy |
| `query_backlinks` | Find all documents linking to a specific page |

### Tasks & Agenda
| Tool | Description |
|------|-------------|
| `list_tasks` | List tasks with optional filters (document, status, date) |
| `list_agenda` | View agenda items for a date range |

### Journals
| Tool | Description |
|------|-------------|
| `get_journal` | Get or create a journal entry for a specific date |
| `list_journals` | List all journal entries |

## Authentication

### Browser Login (recommended)

```bash
npx @inkami/mcp login
```

Opens your browser, authenticates via your inkami account, and saves credentials to `~/.inkami/credentials.json`. Tokens auto-refresh when expired.

### Environment Variables (development)

```bash
INKAMI_TOKEN=<session-jwt> KURA_URL=ws://localhost:8081/sync KURA_TOKEN=<kura-jwt> npx @inkami/mcp
```

### Custom Host

For self-hosted or local development:

```bash
npx @inkami/mcp login --host https://inkami.localhost
```

Or set `INKAMI_API_URL` environment variable.

## About inkami

[inkami](https://inkami.app) is a workspace built for people who think in documents. Write notes, plan projects, track tasks, and keep a daily journal — all in one place with real-time sync across devices.

- **Block-based editor** with markdown shortcuts, tables, code blocks, and checklists
- **Task management** built into your documents — headings become tasks with status tracking
- **Daily journals** with agenda views and date-based scheduling
- **Wiki-style linking** between documents with backlink tracking
- **Full-text search** across your entire workspace
- **Real-time sync** powered by Automerge CRDTs
- **AI integration** for content generation and refinement

Sign up at [inkami.app](https://inkami.app).

## License

MIT