@inkami/mcp

MCP server for inkami — 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

npx @inkami/mcp login

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

Add to Claude Code

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

Add to Claude Desktop

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

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)

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:

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

Or set INKAMI_API_URL environment variable.

About inkami

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

License

MIT