Skip to main content
Glama
Sgoettschkes

nirvana-mcp

by Sgoettschkes
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

nirvana-mcp

MCP server that exposes NirvanaHQ — the GTD task manager — to Claude Code and other MCP-compatible clients.

Status: early. get_inbox is the only tool today. More read-only tools first, then writes. See PLAN.md for the roadmap.

Install into Claude Code

Prerequisites: Node.js 20 or newer (ships with npx) and the Claude Code CLI. Nothing needs to be cloned or globally installed — npx -y downloads the package on demand.

# 1. Get a Nirvana auth token. Prompts for username + password.
npx -y @sgoettschkes/nirvana-mcp login

# 2. Install the server. Paste the token from step 1.
claude mcp add nirvana \
  --env NIRVANA_AUTH_TOKEN=<paste-token-here> \
  -- npx -y @sgoettschkes/nirvana-mcp

# 3. Restart Claude Code, then ask: "What's in my Nirvana inbox?"

To remove: claude mcp remove nirvana.

Related MCP server: ticktick-mcp-server

Tools

Tool

Description

get_inbox

Tasks in the Inbox (state=0) — unprocessed items not yet categorized.

get_next_actions

Tasks marked Next (state=1) — concrete, actionable next steps.

get_waiting_for

Tasks Waiting on someone else (state=2).

get_scheduled

Tasks deferred to a future start date (state=3).

get_someday

Tasks parked in Someday/Maybe (state=4).

get_later

Tasks in the Later list (state=5) — between Next and Someday.

get_trash

Soft-deleted tasks (state=6), still recoverable.

get_logbook

Completed tasks (state=7) — currently returns all-time history.

get_recurring

Recurring task templates (state=9) — the rules, not individual occurrences.

get_focus

Tasks flagged for Focus (seqt > 0), excluding completed/trashed items.

list_projects

Active projects (type=1, state=11).

get_project

One project plus its direct children (tasks and sub-projects). Identify by id or name.

list_areas

High-level life domains (e.g. "work", "personal").

list_tags

Plain tags + GTD contexts + contacts. Each entry has a kind field.

search_tasks

Filter tasks by text (name+note substring), tag, area, and/or state. At least one filter required.

How it works

NirvanaHQ has an undocumented HTTP API at https://api.nirvanahq.com. This server:

  1. Calls auth.new with your username and the MD5 of your password to obtain a long-lived auth token.

  2. Calls the bulk everything endpoint and filters the result client-side to answer each tool.

Your password is hashed locally and never stored. Only the auth token is persisted (in your MCP client's config). Revoke it any time by changing your Nirvana password.

Troubleshooting

  • Nirvana API error 98: Invalid Login Details — wrong username/password.

  • Missing required env var: NIRVANA_AUTH_TOKEN — run nirvana-mcp login first and put the token in your claude mcp add command.

  • Nirvana API error from a tool call — your token was probably revoked (changing your Nirvana password does this). Re-run nirvana-mcp login, then claude mcp remove nirvana && claude mcp add ... with the new token.

Development

git clone https://github.com/Sgoettschkes/nirvana_mcp
cd nirvana_mcp
asdf install                # installs the pinned Node version
npm install
cp .env.example .env        # then fill in NIRVANA_AUTH_TOKEN
npm run dev                 # runs the server against your account
npm run inspect             # opens MCP Inspector

When verifying the published install from inside this repo, the package.json name collides with the npm package, and npx -y @sgoettschkes/nirvana-mcp … will fail with command not found. Run from a different directory (cd ~ && npx …) or use the explicit form: npx -y --package=@sgoettschkes/nirvana-mcp nirvana-mcp ….

License

MIT

Install Server
F
license - not found
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Sgoettschkes/nirvana_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server